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
sapm:
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: [sapm, 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
sapm:
access_token: "${SPLUNK_ACCESS_TOKEN}"
endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace"
# Metrics + Events
signalfx:
access_token: "${SPLUNK_ACCESS_TOKEN}"
realm: "${SPLUNK_REALM}"
service:
extensions: [http_forwarder]
pipelines:
traces:
receivers: [otlp]
processors:
- memory_limiter
- batch
exporters: [sapm]
metrics:
receivers: [otlp]
processors: [memory_limiter, batch]
exporters: [signalfx]
両方の Collector モードでSignalFxエクスポーターを使用する 🔗
また、ホストモニタリング(エージェント)モードとデータ転送(ゲートウェイ)モードの両方で SignalFx エクスポーターをメトリクスに使用する場合は、ゲートウェイでの集約を無効にする必要があります。そのためには、translation_rules
と exclude_metrics
を空のリストに設定する必要があります。
例 🔗
ゲートウェイモードのエージェントを以下のように設定します:
exporters:
# Traces
sapm:
access_token: "${SPLUNK_ACCESS_TOKEN}"
endpoint: "https://ingest.${SPLUNK_REALM}.signalfx.com/v2/trace"
# 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: [sapm]
metrics:
receivers: [signalfx]
processors: [memory_limiter, batch]
exporters: [signalfx]
This page was last updated on 2024年04月23日.