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_ready
と k8s.node.condition_memory_pressure
を出力します:
# ...
k8s_cluster:
node_conditions_to_report:
- Ready
- MemoryPressure
# ...
値は、対応する Condition
の ConditionStatus
が True
の場合は 1
、False
の場合は 0
、Unknown
の場合は -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をご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。