Docs » Splunk Observability Cloud でサポートされているインテグレーション » ホストとサーバーのアプリケーション・レシーバーの設定 » Dockerコンテナ

Dockerコンテナ 🔗

Splunk Distribution of OpenTelemetry Collector は Smart Agent レシーバー と docker-container-stats モニタータイプを使用して、Docker API サーバーからコンテナの統計情報を読み取ります。現在のところCPUシェア/クォータメトリクスをサポートしていないことに注意してください。

このインテグレーションはKubernetes、Linux、Windowsで利用できます。

メリット 🔗

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

インストール 🔗

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

  1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

  2. [設定] セクションの説明に従ってインテグレーションを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

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

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

このインテグレーションをデフォルトのDockerデーモン・ドメインソケットで使用している場合、Docker APIにアクセスする権限を持つために、splunk-otel-collector ユーザーを docker グループに追加する必要がある可能性があります。

usermod -aG docker splunk-otel-collector

例 🔗

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

receivers:
  smartagent/docker-container-stats:
    type: docker-container-stats
    ...  # Additional config

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

service:
 pipelines:
   metrics:
     receivers: [smartagent/docker-container-stats]

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

次の表に、このインテグレーションの設定オプションを示します：

オプション

必須

タイプ

説明

enableExtraBlockIOMetrics

いいえ

bool

すべての追加ブロック IO メトリクスを送信します。デフォルト値は false です

enableExtraCPUMetrics

いいえ

bool

すべての追加 CPU メトリクスを送信します。デフォルト値は false です

enableExtraMemoryMetrics

いいえ

bool

すべての追加メモリ・メトリクスを送信します。デフォルト値は false です

enableExtraNetworkMetrics

いいえ

bool

すべての追加ネットワーク・メトリクスを送信します。デフォルト値は false です

dockerURL

いいえ

string
docker サーバーの URL。デフォルト値は

unix:///var/run/docker.sock です。Windows の場合は、npipe:////.//pipe//docker_engine に設定してください。

timeoutSeconds

いいえ

integer
docker API リクエストの最大待機時間。

デフォルト値は 5 です

cacheSyncInterval

いいえ

integer
docker イベントリスナーを通じてモニターが維持する

コンテナのリストを再同期するまでの待ち時間。例： cacheSyncInterval: "20m"。デフォルト値は 60m です

labelsToDimensions

いいえ

map of strings
コンテナ・ラベル名とディメンション名のマッピング。

対応するラベル値が、マップされた名前のディメンション値となります。例えば、io.kubernetes.container.name: container_spec_name は、io.kubernetes.container.name コンテナ・ラベルの値を持つ container_spec_name というディメンションになります。

envToDimensions

いいえ

map of strings
コンテナ環境変数名からディメンション

名のマッピング。対応する env var 値が、出力されるメトリクスのディメンション値になります。例えば、APP_VERSION: version は、version というディメンションを持つデータポイントになり、その値は、特定のコンテナ用に構成された APP_VERSION envvar の値（存在する場合）になります。

excludedImages

いいえ

list of strings
除外する画像のフィルターのリスト。リテラル、

グロブ、正規表現をサポートします、

メトリクス 🔗

このインテグレーションでは、以下のメトリクスを使用できます：

備考 🔗

  • To learn more about the available in Splunk Observability Cloud see メトリクスタイプ

  • In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、その他のメトリクスの追加 で extraMetrics の設定方法を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

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

プロトコルが利用できないエラー 🔗

Windowsホストでモニターを設定するときに次のエラーメッセージが表示された場合：

Error: Error initializing Docker client: protocol not available

コンフィギュレーションを編集し、unix:///var/run/docker.sock を npipe:////.//pipe//docker_engine に置き換えます。

This page was last updated on 2024年05月29日.