Kubernetesクラスターレシーバー

はじめに

デフォルトでは、Splunk OpenTelemetry Collectors の Helm チャートで Kubernetes クラスターレシーバーがすでに有効になっています。デフォルトの「Collected metrics and dimensions for Kubernetes」を含め、詳細については、「Helm で Collector for Kubernetes を設定する」を参照してください。

Collectorの設定でKubernetesクラスターレシーバーを手動で有効にするには、次の例に示すように、設定ファイルの receiversセクションに k8s_cluster を追加します：

receivers:
  k8s_cluster:
    auth_type: kubeConfig
    collection_interval: 30s
    node_conditions_to_report: ["Ready", "MemoryPressure"]
    allocatable_types_to_report: ["cpu","memory"]
    metadata_exporters: [signalfx]

設定を完了するには、構成ファイルの service セクションの metrics パイプラインにレシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers: [k8s_cluster]

metadata_exporters を同期する

metadata_exporters を Kubernetes クラスターレシーバーが収集したメタデータと同期するメタデータエクスポータのリストとして使用します。例：

receivers:
  k8s_cluster:
    auth_type: serviceAccount
    metadata_exporters:
    - signalfx

このリストで指定されているエクスポータは、次のインターフェイスを実装する必要があります。エクスポータがインターフェイスを実装していない場合、起動が失敗します。

type MetadataExporter interface {
  ConsumeMetadata(metadata []*MetadataUpdate) error
}

type MetadataUpdate struct {
  ResourceIDKey string
  ResourceID    ResourceID
  MetadataDelta
}

type MetadataDelta struct {
  MetadataToAdd    map[string]string
  MetadataToRemove map[string]string
  MetadataToUpdate map[string]string
}

node_conditions_to_report を設定する

以下のコンフィギュレーションを使用すると、k8s_cluster のレシーバーは、コンフィギュレーション内の各条件について、2つのメトリクス、k8s.node.condition_ready と k8s.node.condition_memory_pressure を出力します：

# ...
k8s_cluster:
  node_conditions_to_report:
    - Ready
    - MemoryPressure
# ...

値は、対応する Condition の ConditionStatus が True の場合は 1、False の場合は 0、Unknown の場合は -1 です。詳細については、Kubernetes のドキュメントで「Conditions」を検索してください。

設定

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

メトリクス

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

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

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

トラブルシューティング