UDPログレシーバー 🔗

The UDP log receiver allows the Splunk Distribution of the OpenTelemetry Collector to collect logs over UDP connections. The supported pipeline is logs. See パイプラインでデータを処理する for more information.

はじめに 🔗

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように、UDPログレシーバーを設定します。
Collector を再起動します。

サンプル構成 🔗

UDPレシーバーを有効にするには、以下の設定例のように、agent_config.yaml ファイルの receivers セクションに udplog を追加します：

receivers:
  udplog:
    listen_address: "0.0.0.0:54525"

コンフィギュレーションを完了するには、コンフィギュレーションファイルの service セクションの logs パイプラインに、レシーバーを含めます。例：

service:
  pipelines:
    logs:
      receivers: [udplog]

その他の設定については、設定を参照してください。

演算子を使ってログをフォーマットする 🔗

UDPログレシーバーは、オペレーターを使ってログを希望の形式に処理します。各オペレーターは、ファイルからの行の読み込みや、フィールドからの JSONの解析など、一つの責任を果たします。希望する結果を得るには、パイプラインでオペレーターを連結する必要があります。

例えば、file_input 演算子を使ってファイルから行を読み取ることができます。この操作の結果を regex_parser 演算子に送ると、正規表現パターンに基づいてフィールドが作成されます。次に、file_output 演算子に結果を送って、各行をディスク上のファイルに書き込むことができます。

すべてのオペレーターは、エントリーを作成、変更、または消費します。

エントリーは、パイプラインを通過するログデータの基本的な表現です。
フィールドは、エントリー内の値を参照するために使用されます。
一般的な式の構文は、いくつかの演算子で使用されます。例えば、式はエントリーのフィルターリングやルーティングに使用できます。

利用可能なオペレーター 🔗

利用可能な演算子の完全なリストについては、GitHubの What operators are available? を参照してください。

以下はオペレーターに適用されます：

各オペレーターは type を持っています。
各オペレーターに一意の ID を与えることができます。
- パイプライン内で同じタイプの演算子を複数回使用する場合は、Idを指定する必要があります。
- そうでない場合、Idのデフォルト値は type となります。
演算子は、パイプラインの次の演算子に出力します。
- パイプラインの最後の演算子は、レシーバーから放出されます。
- オプションで、outputパラメータを使って別のオペレーターのIdを指定し、そこに直接ログを渡すこともできます。

パーサー演算子 🔗

文字列から値を分離するには、パーサー演算子を使います。パーサーには、単純なものと複雑なものの2つのクラスがあります。

操作を組み込んだパーサー 🔗

構文解析オペレーターを設定して、タイムスタンプや重大度の構文解析など、特定のフォローアップ操作を埋め込むことができます。

詳細については、複雑なパーサーに関する GitHub のエントリー Parsers を参照してください。

マルチライン構成 🔗

設定されている場合、multiline 設定ブロックは、udplog レシーバーに、改行以外のパターンでログエントリーを分割するように指示します。

multiline 設定ブロックは、line_start_pattern または line_end_pattern のいずれか1つを正確に含んでいなければなりません。これらは、新しいログエントリーの開始、またはログエントリーの終了のいずれかに一致する正規表現パターンです。

omit_pattern を使用して、各エントリの開始／終了パターンを省略することができます。

サポートされているエンコーディング 🔗

以下のエンコーディングに対応しています：

キー	説明
`nop`	エンコーディングの検証は行いません。ファイルを生のバイトストリームとして扱います。
`utf-8`	UTF-8エンコーディング。
`utf-16le`	バイト順がリトルエンディアンのUTF-16エンコーディング。
`utf-16be`	バイト順がビッグエンディアンのUTF-16エンコーディング。
`ascii`	ASCIIエンコーディング。
`big5`	Big5中国語文字エンコーディング。

その他のあまり一般的でないエンコーディングは、ベストエフォートでサポートされています。https://www.iana.org/assignments/character-sets/character-sets.xhtml の利用可能なエンコーディングのリストを参照してください。

設定 🔗

次の表に、UDPレシーバーの設定オプションを示します：

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

このページは 2024年12月12日に最終更新されました。

Related Topics