OpenShiftクラスター

OpenShift クラスターモニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collectorは、Smart Agent レシーバを openshift-cluster モニタータイプで使用して、Kubernetes APIサーバーからクラスターレベルのメトリクスを収集します。これには、Kubernetes クラスター（非推奨）のすべてのメトリクスと、追加の OpenShift 固有のメトリクスが含まれます。OpenShift の展開では openshift-cluster モニターは自動的に組み込まれるため、kubernetes-cluster モニターを使用する必要があるだけです。

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

動作

エージェントは一般的にKubernetesクラスター内の複数の場所で実行されており、一般的にすべてのエージェントインスタンスで同じ設定を共有する方が便利であるため、このモニターはデフォルトで、クラスター内でメトリクスを送信する唯一のエージェントであることを保証するためにリーダー選出プロセスを使用します。

このモニターが設定されている、同じ名前空間で実行されているすべてのエージェントは、どのエージェントがこのモニターのメトリクスを送信するかを相互に決定します。このエージェントはリーダーエージェントになります。残りのエージェントはスタンバイ状態になり、リーダーエージェントがダウンした場合にアクティブ化できるようになります。 alwaysClusterReporter オプションを true に設定することで、リーダーエージェントの選択を上書きできます。これにより、モニターは常にメトリクスを報告するようになります。

メリット

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

インストール

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

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

    デフォルトでは、Collector はログインしている名前空間にインストールされます。Collector を別の名前空間に展開するには、--namespace フラグを使用して Collector を配置する場所を指定します。

    • Kubernetes にインストールする Helm チャートを使用して Kubernetes にインストールする場合、標準 のKubernetes メトリクスに加えて、特定の OpenShift メトリクスを生成するには、--set distribution='openshift' オプションを使用します。

      例：

      SHELL 
      helm install --set cloudProvider=' ' --set distribution='openshift' --set splunkObservability.accessToken='******' --set clusterName='cluster1' --namespace='namespace1' --set splunkObservability.realm='us0' --set gateway.enabled='false' --generate-name splunk-otel-collector-chart/splunk-otel-collector``

      詳細はGitHubレポを参照してください。

    • Linux にインストールする

    • Windows へのインストール

  2. 設定のセクションで説明するように、モニターを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

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

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

設定オプション

次の表に、このモニターの設定オプションを示します：

オプション

必須

タイプ

説明

alwaysClusterReporter

いいえ

bool

 true の場合、リーダー選出はスキップされ、メトリクスが常に

報告されます。デフォルト値は false です。

namespace

いいえ

string

 指定された場合、指定された名前空間内のリソースだけが

モニターされます。省略（空白）の場合、すべての名前空間でサポートされているすべてのリソースが監視されます。

kubernetesAPI

いいえ

object

K8s APIクライアントの設定

nodeConditionTypesToReport

いいえ

list of strings

メトリクスとして報告するノードステータス状態の種類のリスト。メトリクスは、kubernetes.node_<type_snake_cased> 形式のデータポイントとして報告され、0 は「False」、1は「True」、-1は「Unknown」に対応します。デフォルト値は [Ready] です。

ネストされた kubernetesAPI コンフィギュレーション・オブジェクトには以下のフィールドがあります：

オプション

必須

タイプ

説明

authType

いいえ

string

 K8s API サーバーの認証方法。これは、次のいずれかになります。

none（認証なしの場合）、tls（手動で指定した TLS クライアント証明書を使用する。非推奨)、serviceAccount（エージェントポッドに提供された標準サービスアカウントトークンを使用する）、または kubeConfig（~/.kube/config の認証情報のために使用）。デフォルト値は serviceAccount です。

skipVerify

いいえ

bool

 APIサーバーからのTLS証明書の検証をスキップするかどうか。

ほとんど必要ありません。デフォルト値は false です。

clientCertPath

いいえ

string

 ポッドのファイルシステム上のTLSクライアント証明書へのパス

tls 認証を使用する場合。

clientKeyPath

いいえ

string

 ポッドのファイルシステム上のTLSクライアント鍵へのパス

tls 認証。

caCertPath

いいえ

string

 API サーバーの TLS 証明書を検証する際に使用する CA 証明書へのパス。

通常、これはKubernetesがサービスアカウント・トークンと一緒に提供し、自動的にピックアップされるので、指定する必要はほとんどないはずです。

メトリクス

このインテグレーションでは、以下のメトリクスを使用できます：

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/kubernetes/cluster/metadata.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.