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

Dockerコンテナ 🔗

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the docker-container-stats monitor type to read container stats from a Docker API server. Note it doesn’t currently support CPU share/quota metrics.

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

メリット 🔗

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

  • メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示する を参照してください。

  • Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。

  • Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、Search the Metric Finder and Metadata Catalog を参照してください。

インストール 🔗

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

  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

DockerコンテナのログをSplunk Enterpriseインスタンスに送信する方法の説明については、Tutorial: Use the Collector to send container logs to Splunk Enterprise を参照してください。

🔗

このインテグレーションを有効にするには、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.socknpipe:////.//pipe//docker_engine に置き換えます。

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