Kubernetesイベント 🔗

The Splunk Distribution of OpenTelemetry Collector uses the Smart Agent receiver with the kubernetes-events monitor type to listen for Kubernetes events. The integration calls the Kubernetes API running on manager nodes, and sends Kubernetes events into Splunk Observability Cloud as Infrastructure Monitoring events through the OpenTelemetry pipeline.

開始後、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をご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

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

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

このページは 2024年12月09日に最終更新されました。

Related Topics