InfraおよびAPMの関連コンテンツを有効にするために Collector を設定する 🔗

Splunk Distribution of the OpenTelemetry Collector のデフォルト設定は、関連コンテンツを自動的に設定します。カスタム設定を使用している場合は、続きをお読みください。

関連コンテンツの紹介については、Splunk Observability Cloudの関連コンテンツを参照してください。

Collector をホストモニタリング（エージェント）モードで設定して、関連コンテンツを有効にします。 🔗

APM サービスのダッシュボードでインフラストラクチャデータを表示するには、OpenTelemetry Collector の特定のコンポーネントを有効にする必要があります。詳しくは Collector コンポーネントとパイプラインでデータを処理するを参照してください。

ホストモニタリングモードでの Collector 設定 🔗

以上が必要なコンフィギュレーションの詳細です：

`hostmetrics` レシーバー 🔗

cpu、memory、filesystem、network を有効にして、それぞれのメトリクスを収集します。

詳細は、ホスト・メトリクス・レシーバーを参照してください。

`signalfx` エクスポーター 🔗

SignalFx エクスポーターは、hostmetrics レシーバーからのメトリクスを集約します。また、関連するAPMサービスチャートで参照される cpu.utilization のようなメトリクスも送信します。

詳細は、SignalFx エクスポーターを参照してください。

相関フラグ 🔗

デフォルトでは、標準のSignalFxエクスポーター構成を使用して相関が有効になっています。この設定により、Collectorは関連するAPIコールを実行し、スパンと関連するインフラストラクチャ・メトリクスをリンクします。

SignalFx エクスポーターは、メトリクスパイプラインとトレースパイプラインの両方で有効になっている必要があります。相関オプションをさらに調整するには、設定で SignalFx エクスポーターのオプションを参照してください。

`resourcedetection` プロセッサー 🔗

このプロセッサーを使用すると、メトリクスとトレースに一意の host.name 値を設定できます。 host.name はEC2ホスト名またはシステムホスト名によって決定されます。

以下のコンフィギュレーションを使用します：

クラウドプロバイダーまたは環境変数を使用して、host.name を設定します。
override を有効にする

詳細は、リソース検出プロセッサーを参照してください。

`resource/add_environment` プロセッサー（オプション） 🔗

APM チャートは、環境スパン属性が正しく設定されている必要があります。

この属性を設定するには、2つのオプションがあります：

インストルメンテーションで属性を設定する
このプロセッサーを使用して、すべてのスパンに deployment.environment スパン属性を挿入します。

詳細は、リソース検出プロセッサーを参照してください。

例 🔗

以下は各セクションの関連する設定スニペットです：

receivers:
  hostmetrics:
    collection_interval: 10s
    scrapers:
      cpu:
      disk:
      filesystem:
      memory:
      network:

processors:
  resourcedetection:
    detectors: [system,env,gcp,ec2]
    override: true
  resource/add_environment:
    attributes:
      - action: insert
        value: staging
        key: deployment.environment

exporters:
  # Traces
  otlphttp:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    endpoint: "${SPLUNK_TRACE_URL}"
  # Metrics + Events + APM correlation calls
  signalfx:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    api_url: "${SPLUNK_API_URL}"
    ingest_url: "${SPLUNK_INGEST_URL}"
    sync_host_metadata: true
    correlation:

service:
  extensions: [health_check, http_forwarder, zpages]
  pipelines:
    traces:
      receivers: [jaeger, zipkin]
      processors: [memory_limiter, batch, resourcedetection, resource/add_environment]
      exporters: [otlphttp, signalfx]
    metrics:
      receivers: [hostmetrics]
      processors: [memory_limiter, batch, resourcedetection]
      exporters: [signalfx]

Collector を設定して、関連コンテンツを有効にするをホストモニタリング（エージェント）モードからデータ転送（ゲートウェイ）モードに有効にします。 🔗

Opentelemetry Collector をホストモニタリング (エージェント) とデータ転送 (ゲートウェイ) の両方のモードで実行する必要がある場合は、以下のセクションを参照してください。

詳細は Collector のデプロイモードを参照してください。

エージェントを設定する 🔗

前のセクションで述べたのと同じ手順に従って、以下の変更を含めます：

`http_forwarder` エクステンション 🔗

http_forwarder はポート 6060 でリッスンし、すべての REST API 呼び出しを Splunk Observability Cloud に直接送信します。

エージェントが Splunk SaaS バックエンドと直接通信できない場合は、egress エンドポイントを使用してゲートウェイの URL に変更します。

`signalfx` エクスポーター 🔗

注意

トレースの相関に必要な REST API 呼び出しは、traces パイプラインの SignalFx エクスポーター経由で送信する必要があります。

必要であれば、OTLPエクスポーターを使用するのがベストですが、メトリクスス用のエクスポーターを使用することもできます。詳しくは otlp exporter (オプション) を参照してください。

以下のコンフィギュレーションを使用します：

api_url のエンドポイントをゲートウェイの URL に設定します。ゲートウェイの http_forwarder のイングレスポートを指定します。デフォルトでは 6060 です。
ingest_url エンドポイントをゲートウェイの URL に設定します。ゲートウェイの signalfx レシーバーのイングレスポートを指定します。デフォルトでは 9943 です。

すべてのパイプライン 🔗

すべてのメトリクス、トレース、ログのパイプラインをゲートウェイの適切なレシーバーに送信します。

`otlp exporter` (オプション) 🔗

OTLP エクスポーターの使用はオプションですが、エージェントからゲートウェイへのトラフィックの大部分に推奨します。すべてのデータは受信時に otlp に変換されるため、OTLP エクスポーターはゲートウェイにデータを送信する最も効率的な方法です。SignalFx エクスポーターは、トレースパイプラインで REST API 呼び出しを行う場合にのみ使用してください。

OTLPエクスポーターは grpc プロトコルを使うので、エンドポイントはゲートウェイのIPアドレスとして定義されなければなりません。

注釈

メトリクスに OTLP エクスポーターを使用している場合、hostmetrics 集約はゲートウェイで実行する必要があります。

詳細は、OTLPエクスポーターを参照してください。

例 🔗

以下は各セクションの関連する設定スニペットです：

receivers:
  hostmetrics:
    collection_interval: 10s
    scrapers:
      cpu:
      disk:
      filesystem:
      memory:
      network:

processors:
  resourcedetection:
    detectors: [system,env,gcp,ec2]
    override: true
  resource/add_environment:
    attributes:
      - action: insert
        value: staging
        key: deployment.environment

exporters:
  # Traces
  otlp:
    endpoint: "${SPLUNK_GATEWAY_URL}:4317"
    tls:
      insecure: true
  # Metrics + Events + APM correlation calls
  signalfx:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    api_url: "http://${SPLUNK_GATEWAY_URL}:6060"
    ingest_url: "http://${SPLUNK_GATEWAY_URL}:9943"

service:
  extensions: [health_check, http_forwarder, zpages]
  pipelines:
    traces:
      receivers: [jaeger, zipkin]
      processors: [memory_limiter, batch, resourcedetection, resource/add_environment]
      exporters: [otlp, signalfx]
    metrics:
      receivers: [hostmetrics]
      processors: [memory_limiter, batch, resourcedetection]
      exporters: [otlp]

ゲートウェイを設定する 🔗

ゲートウェイモードでは、関連するレシーバーがエージェントからのエクスポーターと一致するようにします。さらに、以下の変更を行う必要があります。

`http_forwarder` エクステンション 🔗

http_forwarder はポート 6060 でリッスンし、すべての REST API 呼び出しを Splunk Observability Cloud に直接送信します。

ゲートウェイモードでは、egress エンドポイントを Splunk Observability Cloud SaaS エンドポイントに設定します。

`signalfx` エクスポーター 🔗

translation_rules と exclude_metrics フラグの両方をデフォルト値に設定します。したがって、コメントアウトするか、単に削除することができます。これにより、エージェント上のSignalFxエクスポーターによって通常実行される hostmetrics 集約が、ゲートウェイ上のSignalFxエクスポーターによって代わりに実行されるようになります。

例 🔗

以下は各セクションの関連する設定スニペットです：

extensions:
  http_forwarder:
    egress:
      endpoint: "https://api.${SPLUNK_REALM}.signalfx.com"

receivers:
  otlp:
    protocols:
      grpc:
      http:
  signalfx:

exporters:
  # Traces
  otlphttp:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    traces_endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace/otlp"
  # Metrics + Events
  signalfx:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    realm: "${SPLUNK_REALM}"

service:
  extensions: [http_forwarder]
  pipelines:
    traces:
      receivers: [otlp]
      processors:
      - memory_limiter
      - batch
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [memory_limiter, batch]
      exporters: [signalfx]

両方の Collector モードでSignalFxエクスポーターを使用する 🔗

また、ホストモニタリング（エージェント）モードとデータ転送（ゲートウェイ）モードの両方で SignalFx エクスポーターをメトリクスに使用する場合は、ゲートウェイでの集約を無効にする必要があります。そのためには、translation_rules と exclude_metrics を空のリストに設定する必要があります。

例 🔗

ゲートウェイモードのエージェントを以下のように設定します：

exporters:
  # Traces
  otlphttp:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace/otlp"
  # Metrics + Events
  signalfx:
    access_token: "${SPLUNK_ACCESS_TOKEN}"
    realm: "${SPLUNK_REALM}"
    translation_rules: []
    exclude_metrics: []

service:
  extensions: [http_forwarder]
  pipelines:
    traces:
      receivers: [otlp]
      processors:
      - memory_limiter
      - batch
      exporters: [otlphttp]
    metrics:
      receivers: [signalfx]
      processors: [memory_limiter, batch]
      exporters: [signalfx]

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

Related Topics

Was this topic useful?

Splunk

Related Topics

InfraおよびAPMの関連コンテンツを有効にするために Collector を設定する 🔗

Collector をホストモニタリング（エージェント）モードで設定して、関連コンテンツを有効にします。 🔗

ホストモニタリングモードでの Collector 設定 🔗

hostmetrics レシーバー 🔗

signalfx エクスポーター 🔗

相関フラグ 🔗

resourcedetection プロセッサー 🔗

resource/add_environment プロセッサー（オプション） 🔗

例 🔗

Collector を設定して、関連コンテンツを有効にするをホストモニタリング（エージェント）モードからデータ転送（ゲートウェイ）モードに有効にします。 🔗

エージェントを設定する 🔗

http_forwarder エクステンション 🔗

signalfx エクスポーター 🔗

すべてのパイプライン 🔗

otlp exporter (オプション) 🔗

例 🔗

ゲートウェイを設定する 🔗

http_forwarder エクステンション 🔗

signalfx エクスポーター 🔗

例 🔗

両方の Collector モードでSignalFxエクスポーターを使用する 🔗

例 🔗

Was this topic useful?

`hostmetrics` レシーバー 🔗

`signalfx` エクスポーター 🔗

`resourcedetection` プロセッサー 🔗

`resource/add_environment` プロセッサー（オプション） 🔗

`http_forwarder` エクステンション 🔗

`signalfx` エクスポーター 🔗

`otlp exporter` (オプション) 🔗

`http_forwarder` エクステンション 🔗

`signalfx` エクスポーター 🔗