Kubernetesクラスターレシーバー 🔗

Kubernetes cluster receiverは、Kubernetes APIサーバーを使用してクラスターメトリクスを収集します。このレシーバーの単一のインスタンスを使用して、Kubernetesクラスター全体を監視できます。サポートされるパイプラインタイプは metrics です。コンテナ、ポッド、ノード、名前空間、クラスターなど、他のKubernetes要素をフィルターインまたはフィルターアウトするには、代わりにFilterプロセッサーを使用します。詳しくはフィルタープロセッサーを参照してください。パイプラインの種類については、パイプラインでデータを処理するを参照してください。

Kubernetesバージョン1.21以上がKubernetesナビゲーターと互換性があります。それ以下のバージョンのKubernetesの使用はこのレシーバーではサポートされておらず、ナビゲーターにすべてのクラスターが表示されない可能性があります。

注釈

このレシーバーは、kubernetes-cluster Smart Agent モニターに代わるものです。

はじめに 🔗

デフォルトでは、Splunk OpenTelemetry CollectorsのHelmチャートでKubernetesクラスターレシーバーがすでに有効になっています。デフォルトの Helmで Collector for Kubernetes を設定するを含め、詳細は 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」を検索してください。

設定 🔗

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

メトリクス 🔗

注意

SignalFxエクスポーターは、デフォルトでいくつかの利用可能なメトリクスを除外します。デフォルトのメトリクスフィルターについては、デフォルトで除外されるメトリクスのリストを参照してください。CollectorがKubernetesメトリクスをどのように処理するかについては、Kubernetesのメトリクスとディメンションの収集を参照してください。

The following metrics, resource attributes, and attributes are available. For more information, including which resource attributes are included by default, refer to Kubernetes Cluster receiver metadata in GitHub.

特定のメトリクスをアクティブまたは非アクティブにする 🔗

各メトリクスの metrics セクションの enabled フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

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

以下は、アクティブ化されたメトリクスを持つホスト・メトリクス・レシーバーの構成例です：

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

注釈

無効化されたメトリクスは Splunk Observability Cloud に送信されません。

請求 🔗

MTSベースのサブスクリプションでは、すべてのメトリクスがメトリクスの使用量にカウントされます。
ホストベースのプランに加入している場合、このドキュメントでアクティブ（Active: Yes）と記載されているメトリクスはデフォルトとみなされ、無料で含まれます。

詳しくは Infrastructure Monitoringのサブスクリプション使用状況（ホストとメトリクスのプラン）を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

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

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月17日に最終更新されました。

Related Topics