Kubernetesイベント 🔗

Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバーを kubernetes-events モニタータイプで使用し、Kubernetesイベントをリッスンします。このインテグレーションはマネージャーノード上で実行されているKubernetes APIを呼び出し、KubernetesイベントをOpenTelemetryパイプラインを通してInfrastructure MonitoringイベントとしてSplunk Observability Cloudに送信します。

開始後、Kubernetesイベント・モニタータイプは、Kubernetesがまだ永続化されている全てのイベントと、新しいイベントを送信します。様々なエージェントが、どのインスタンスがイベントをリードし、送信するかを決定します。alwaysClusterReporter が true に設定されている場合、すべてのノードが同じデータを送信し、マネージャノードへの追加のクエリはありません。

このモニタータイプは、Kubernetes、Linux、Windowsで利用できます。

メリット 🔗

これらの機能にアクセスできるようにインテグレーションを設定します：

イベントを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターはビルトインダッシュボードも提供します。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

Helmありでデプロイする 🔗

Helmチャートでこのモニターを有効にするには、helm installコマンドにこの引数を含めます：

-set splunkObservability.infrastructureMonitoringEventsEnabled='true'

Helmなしでデプロイする 🔗

Helmなしでデプロイするには、OTelコンフィギュレーションに以下を含めます：

processors:
  resource/add_event_k8s:
    attributes:
      - action: insert
        key: kubernetes_cluster
        value: CHANGEME

receivers:
  smartagent/kubernetes-events:
   type: kubernetes-events
   alwaysClusterReporter: true

service:
  pipelines:
    logs/events:
      exporters:
        - signalfx
      processors:
        - memory_limiter
        - batch
        - resourcedetection
        - resource/add_event_k8s
      receivers:
        - smartagent/kubernetes-events

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
   smartagent/kubernetes-events:
   type: kubernetes-events
   ... # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

services:
  logs/events:
    receivers:
      - smartagent/kubernetes-events

最後に、送信するイベントを設定します。以下のコマンドで、クラスターで発生しているイベントの種類を確認できます：

kubectl get events -o yaml --all-namespaces

すべてのイベントを送信するには、values.yamlで _sendAllEvents オプションを true に設定し、whitelistedEvents オプションを削除します。

出力から、Reason （Started、Created、Scheduled）と Kind （Pod、ReplicaSet、Deployment…）を組み合わせて、送信するイベントを選択します。- 許可したいイベント・ルールごとに、reason と involveObjectKind を個別に指定します。- イベントは、送信したいイベントのリストとして whitelistedEvents 設定オプションに配置されます。- イベント名は理由名と一致します。

コンフィギュレーション設定 🔗

オプション	必須	タイプ	説明
`kubernetesAPI`	いいえ	`object (see below)`	Kubernetes APIクライアントの設定。
`whitelistedEvents`	いいえ	`list of objects (see below)`	イベントを送信するイベントタイプのリスト。これらのアイテムにマッチするイベントのみ送信されます。
`alwaysClusterReporter`	いいえ	`bool`	このエージェントインスタンスから常にイベントを送信するか、あるいは 1つのエージェントインスタンスからのみ送信するためのリーダー選出をするかどうか。デフォルトは `false` です。

ネストされた kubernetesAPI コンフィグ・オブジェクトは以下のフィールドを持ちます：

オプション	必須	タイプ	説明
`authType`	いいえ	`string`	K8s APIサーバーの認証を行います：- 認証なしは `none`。 -手動で指定したTLSクライアント証明書を使用するには `tls` （非推奨）。- エージェントポッドに提供された標準サービスアカウントトークンを使用するには `serviceAccount`。- `~/.kube/config` の認証情報を使用するには `kubeConfig`。- デフォルトは `serviceAccount` です。
`skipVerify`	いいえ	`bool`	APIサーバー。からのTLS証明書の検証をスキップするかどうか。ほとんど必要ありません。デフォルトは `false` です
`clientCertPath`	いいえ	`string`	ポッドのファイルシステム上にあるTLSクライアント証明書へのパス ( `tls` 認証を使用する場合)。
`clientKeyPath`	いいえ	`string`	TLS証明書を使用する場合、ポッドのファイルシステム上のTLSクライアント鍵へのパス。 ( `tls` 認証を使用する場合)。
`caCertPath`	いいえ	`string`	APIサーバーTLS証明書を検証する際に使用するCA証明書へのパス。通常、この証明書はK8sによってサービスアカウントトークンと一緒に提供され、自動的にピックアップされるため、指定する必要はほとんどありません。

ネストされた whitelistedEvents コンフィギュレーション・オブジェクトは以下のフィールドを持ちます：

オプション	必須	タイプ
`reason`	いいえ	`string`
`involvedObjectKind`	いいえ	`string`

YAML設定の例：

receivers:
   smartagent/kubernetes-events:
     type: kubernetes-events
     whitelistedEvents:
       - reason: Created
         involvedObjectKind: Pod
       - reason: SuccessfulCreate
         involvedObjectKind: ReplicaSet

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

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月11日に最終更新されました。

Related Topics