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

Kubernetesイベント 🔗

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

開始後、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年05月29日.