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 に設定することで、リーダーエージェントの選択を上書きできます。これにより、モニターは常にメトリクスを報告するようになります。

メリット

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

メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。

インストール

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

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

デフォルトでは、Collector はログインしている名前空間にインストールされます。Collector を別の名前空間に展開するには、--namespace フラグを使用して Collector を配置する場所を指定します。
- Kubernetes にインストールする Helm チャートを使用して Kubernetes にインストールする場合、標準のKubernetes メトリクスに加えて、特定の OpenShift メトリクスを生成するには、--set distribution='openshift' オプションを使用します。
  
  例：
```
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 へのインストール
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：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 の設定方法を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______