Docs » Splunk Observability Cloud でサポートされているインテグレーション » Collectorコンポーネント: レシーバー » Kubernetesクラスターレシーバー

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

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

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

注釈

This receiver replaces the kubernetes-cluster Smart Agent monitor.

はじめに 🔗

By default, the Kubernetes cluster receiver is already activated in the Helm chart of the Splunk OpenTelemetry Collectors. See Helmで Collector for Kubernetes を設定する for more information, including the default 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_readyk8s.node.condition_memory_pressure を出力します:

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

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

設定 🔗

The following table shows the configuration options for the receiver:

メトリクス 🔗

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

注釈

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

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

各メトリクスの 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 に送信されません。

Billing 🔗

  • If you’re in a MTS-based subscription, all metrics count towards metrics usage.

  • If you’re in a host-based plan, metrics listed as active (Active: Yes) on this document are considered default and are included free of charge.

Learn more at Infrastructure Monitoringのサブスクリプション使用状況(ホストとメトリクスのプラン).

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

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

Splunk Observability Cloudをご利用のお客様

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

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

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

This page was last updated on 2024年11月13日.