Docs » Splunk Observability Cloud でサポートされているインテグレーション » オーケストレーションのためにアプリケーション・レシーバーを設定する » Kubernetesイベント

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がまだ永続化されている全てのイベントと、新しいイベントを送信します。様々なエージェントが、どのインスタンスがイベントをリードし、送信するかを決定します。alwaysClusterReportertrue に設定されている場合、すべてのノードが同じデータを送信し、マネージャノードへの追加のクエリはありません。

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

メリット 🔗

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

  • イベントを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターはビルトインダッシュボードも提供します。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示する を参照してください。

  • Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。

インストール 🔗

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

  1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:

  2. [設定] セクションの説明に従ってインテグレーションを設定します。

  3. 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 のインテグレーションを使用するには、以下の手順に従います:

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、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…)を組み合わせて、送信するイベントを選択します。- 許可したいイベント・ルールごとに、reasoninvolveObjectKind を個別に指定します。- イベントは、送信したいイベントのリストとして 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 Answers のコミュニティサポートで質問し、回答を得る

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

This page was last updated on 2024年09月18日.