Logstash TCP 🔗

Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバーと logstash-tcp モニタータイプを使用して、Logstash Monitoring APIを通じてLogstashデプロイの健全性とパフォーマンスを監視します。server または client モードで動作するlogstash tcp出力プラグインからイベントをフェッチし、データポイントに変換します。

このインテグレーションは、イベントをメトリクスに変換するLogstash Metrics filterプラグインと組み合わせて使用することを意図しています。このモニターが client モードのときのみ、自動検出を使用できます。

このレシーバーはLinuxとWindowsで利用できます。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索するを参照してください。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetesにインストールする
- Linuxにインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

### 例

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/logstash-tcp:
    type: logstash-tcp
    ... # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/logstash-tcp]

例：Logstash Metricsプラグインの設定 🔗

次の例は、Logstash Metrics フィルター・プラグインから timer と meter の両方のメトリクスを使用する方法を示しています：

input {
  file {
    path => "/var/log/auth.log"
    start_position => "beginning"
    tags => ["auth_log"]
  }

  # A contrived file that contains timing messages
  file {
    path => "/var/log/durations.log"
    tags => ["duration_log"]
    start_position => "beginning"
  }
}

filter {
  if "duration_log" in [tags] {
    dissect {
      mapping => {
        "message" => "Processing took %{duration} seconds"
      }
      convert_datatype => {
        "duration" => "float"
      }
    }
    if "_dissectfailure" not in [tags] { # Filter out bad events
      metrics {
        timer => { "process_time" => "%{duration}" }
        flush_interval => 10
        # This makes the timing stats pertain to only the previous 5 minutes
        # instead of since Logstash last started.
        clear_interval => 300
        add_field => {"type" => "processing"}
        add_tag => "metric"
      }
    }
  }
  # Count the number of logins using SSH from /var/log/auth.log
  if "auth_log" in [tags] and [message] =~ /sshd.*session opened/ {
    metrics {
      # This determines how often metric events will be sent to the agent, and
      # thus how often data points will be emitted.
      flush_interval => 10
      # The name of the meter will be used to construct the name of the metric
      # in Splunk Infrastructure Monitoring. For this example, a data point called `logins.count` would
      # be generated.
      meter => "logins"
      add_tag => "metric"
    }
  }
}

output {
  # This can be helpful to debug
  stdout { codec => rubydebug }

  if "metric" in [tags] {
    tcp {
      port => 8900
      # The agent will connect to Logstash
      mode => "server"
      # Needs to be "0.0.0.0" if running in a container.
      host => "127.0.0.1"
    }
  }
}

Logstashが上記のコンフィギュレーションで構成されると、logstash-tcp モニターは logins.count と process_time.<timer_field> を収集します。

コンフィギュレーション設定 🔗

次の表に、このモニタータイプの設定オプションを示します：

オプション	必須	タイプ	説明
`host`	はい	`string`	`mode: server` の場合、リッスンするローカルIPアドレス。 `mode: client` の場合は、接続するLogstashホスト/IP。
`port`	いいえ	`integer`	`mode: server` の場合は、リッスンするローカルポート。 `mode: client` の場合は、Logstash TCP出力プラグインのポート。ポートが `0` の場合、カーネルによってランダムなリスニングポートが割り当てられます。(デフォルト： `0` )
`mode`	いいえ	`string`	`server` または `client` として機能するかどうか。Logtash `tcp` 出力プラグインの対応する設定は、これと逆に設定する必要があります。(デフォルト： `client` )
`desiredTimerFields`	いいえ	`list of strings`	(デフォルト： `[mean, max, p99, count]` )
`reconnectDelay`	いいえ	`integer`	TCP接続ができないか、切断された後に再接続するまでの待機時間。(デフォルト： `5s` )
`debugEvents`	いいえ	`bool`	`true` の場合、Logstashから受信したイベントは、デシリアライズされた形式のエージェントの標準出力にダンプされます。(デフォルト： `false` )

メトリクス 🔗

このインテグレーションで利用可能なメトリクスはありません。

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

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

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

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

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

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

Related Topics