ホスト・メトリクス・レシーバー

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

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

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するようにレシーバーを設定します。

3. Collector を再起動します。

コンテナ・ホストのメトリクスを収集する（Linux）

ホストメトリクスレシーバは、Linux システムディレクトリからメトリクスを収集します。コンテナではなくホストのメトリクスを収集するには、次の手順に従います。

1. コンテナを実行するときに、ホストファイルシステム全体をマウントします。次に例を示します。docker run -v /:/hostfs ホストファイルシステムのどの部分をマウントするか選択することもできます。例： docker run -v /proc:/hostfs/proc

2. root_path を設定して、ホストメトリクスレシーバがルートファイルシステムの場所を認識できるようにします。例：

   YAMLCopy

   receivers: hostmetrics: root_path: /hostfs

   receivers:
   hostmetrics:
      root_path: /hostfs

   ホスト・メトリクス・レシーバーの複数のインスタンスを実行している場合は、すべてのインスタンスに同じ root_path を設定します。

サンプル構成

次の例に示すように、収集間隔とスクレイピングするメトリクスのカテゴリを構成できます：

hostmetrics:
  collection_interval: <duration> # The default is 1m.
  scrapers:
    <scraper1>:
    <scraper2>:
    ...

スクレーパはエンドポイントからデータを抽出し、そのデータを指定されたターゲットに送信します。利用可能なスクレーパを以下の表に記載します。

スクレーパーの構成については、以下のセクションを参照してください。

ディスク

disk:
  <include|exclude>:
    devices: [ <device name>, ... ]
    match_type: <strict|regexp>

ファイルシステム

filesystem:
  <include_devices|exclude_devices>:
    devices: [ <device name>, ... ]
    match_type: <strict|regexp>
  <include_fs_types|exclude_fs_types>:
    fs_types: [ <filesystem type>, ... ]
    match_type: <strict|regexp>
  <include_mount_points|exclude_mount_points>:
    mount_points: [ <mount point>, ... ]
    match_type: <strict|regexp>

以下の例では、Linuxシステムの一般的なマウント・ポイントとして、フォワード・スラッシュ（ / ）を使用しています：

filesystem:
  include_mount_points:
    mount_points: ["/"]
    match_type: strict

同様に、以下の例では、Windowsシステムの一般的なマウントポイントとして C: を示しています：

filesystem:
  include_mount_points:
    mount_points: ["C:"]
    match_type: strict

仮想ファイルシステムを含めるには、include_virtual_filesystems を true に設定します。

filesystem:
  include_virtual_filesystems: true

GitHubのdaemonset.yamlファイルに、より多くの例があります。

ネットワーク

network:
  <include|exclude>:
    interfaces: [ <interface name>, ... ]
    match_type: <strict|regexp>

プロセス

process:
  <include|exclude>:
    names: [ <process name>, ... ]
    match_type: <strict|regexp>
  mute_process_name_error: <true|false>
  mute_process_exe_error: <true|false>
  mute_process_io_error: <true|false>
  scrape_process_delay: <time>

以下の例では、デフォルトに加えて2つのメトリクスを収集し、リソース属性を使用して収集データにプロセスオーナを含めるプロセススクレーパーの設定方法を示します：

receivers:
  hostmetrics:
    scrapers:
      process:
        resource_attributes:
          process.owner:
            enabled: true
        metrics:
          process.memory.usage:
            enabled: true
          process.disk.io:
            enabled: true

プロセススクレーパを使用したメトリクスとリソース属性の有効化と無効化の詳細については、OpenTelemetry ドキュメントの hostmetricsreceiver/process を参照してください。

プロセスの読み取りに関するエラーが継続的に表示される場合は、mute_process_name_error、mute_process_exe_error、または mute_process_io_error を true に設定することを検討してください。

フィルターリング

特定のソースからのメトリクスのサブセットのみを収集するには、filter プロセッサーでホスト・メトリクス・レシーバーを使用します。

さまざまな頻度

あるメトリクスを他のメトリクスとは異なる頻度でスクレイピングするには、異なる collection_interval 値で複数のホストメトリクスレシーバを構成してください。例：

receivers:
  hostmetrics:
    collection_interval: 30s
    scrapers:
      cpu:
      memory:

  hostmetrics/disk:
    collection_interval: 1m
    scrapers:
      disk:
      filesystem:

service:
  pipelines:
    metrics:
      receivers: [hostmetrics, hostmetrics/disk]

メトリクス

以下のメトリクス、リソース属性、および属性が使用できます。

CPUスクレーパー

詳しくは、GitHub の「cpu scraper documentation」を参照してください。

ディスクスクレーパー

詳細については、GitHub の「disk scraper documentation」を参照してください。

ファイルシステムスクレーパー

詳細については、GitHub の「filesystem scraper documentation」を参照してください。

ロードスクレーパー

詳細については、GitHub の「load scraper documentation」を参照してください。

メモリスクレーパー

詳細については、GitHub の「memory scraper documentation」を参照してください。

ネットワークスクレーパー

詳細については、GitHub の「network scraper documentation」を参照してください。

ページングスクレーパー

詳細については、GitHub の「paging scraper documentation」を参照してください。

プロセススクレーパー

詳細については、GitHub の「process scraper documentation」を参照してください。

プロセススクレーパー

詳細については、GitHub の「processes scraper documentation」を参照してください。

リソース属性

ホストメトリクスレシーバーは、エクスポートされたメトリクスにリソース属性を設定しません。

リソース属性を設定するには、OTEL_RESOURCE_ATTRIBUTES 環境変数を使用します。例：

export OTEL_RESOURCE_ATTRIBUTES="service.name=<name_of_service>,service.version=<version_of_service>"

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true

設定

以下の表に、ホスト・メトリクス・レシーバーの構成オプションを示します：

トラブルシューティング