10.7. Zero Trust Workload Identity Manager のモニタリング
デフォルトでは、Zero Trust Workload Identity Manager の SPIRE Server および SPIRE Agent コンポーネントがメトリクスを出力します。Prometheus Operator 形式を使用してこれらのメトリクスを収集するように OpenShift Monitoring を設定できます。
10.7.1. ユーザーワークロードモニタリングの有効化 リンクのコピーリンクがクリップボードにコピーされました!
クラスターでユーザーワークロードモニタリングを設定することで、ユーザー定義プロジェクトのモニタリングを有効にできます。
前提条件
-
cluster-adminクラスターロールを持つユーザーとしてクラスターにアクセスできる。
手順
cluster-monitoring-config.yamlファイルを作成し、ConfigMapを定義および設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して
ConfigMapを適用します。oc apply -f cluster-monitoring-config.yaml
$ oc apply -f cluster-monitoring-config.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
ユーザーワークロードのモニタリングコンポーネントが
openshift-user-workload-monitoringnamespace で実行されていることを確認します。oc -n openshift-user-workload-monitoring get pod
$ oc -n openshift-user-workload-monitoring get podCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
prometheus-operator、prometheus-user-workload、thanos-ruler-user-workload などの Pod のステータスが Running である必要があります。
10.7.2. サービスモニターを使用した SPIRE Server のメトリクス収集の設定 リンクのコピーリンクがクリップボードにコピーされました!
SPIRE Server のオペランドは、デフォルトで /metrics エンドポイントのポート 9402 でメトリクスを公開します。Prometheus Operator によるカスタムメトリクスの収集を可能にする ServiceMonitor カスタムリソース (CR) を作成することで、SPIRE Server のメトリクス収集を設定できます。
前提条件
-
cluster-adminクラスターロールを持つユーザーとしてクラスターにアクセスできる。 - Zero Trust Workload Identity Manager がインストールされている。
- クラスターに SPIRE Server のオペランドがデプロイされている。
- ユーザーワークロードモニタリングが有効になっている。
手順
ServiceMonitorCR を作成します。ServiceMonitorCR を定義する YAML ファイルを作成します。servicemonitor-spire-serverファイルの例Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して
ServiceMonitorCR を作成します。oc create -f servicemonitor-spire-server.yaml
$ oc create -f servicemonitor-spire-server.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow ServiceMonitorCR が作成されると、ユーザーワークロードの Prometheus インスタンスが、SPIRE Server からのメトリクス収集を開始します。収集されたメトリクスには、job="spire-server"というラベルが付けられます。
検証
-
OpenShift Container Platform Web コンソールで、Observe
Targets に移動します。 Label フィルターフィールドに次のラベルを入力して、メトリクスターゲットをフィルタリングします。
service=spire-server
$ service=spire-serverCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
spire-server-metricsエントリーの Status 列にUpと表示されていることを確認します。
10.7.3. サービスモニターを使用した SPIRE Agent のメトリクス収集の設定 リンクのコピーリンクがクリップボードにコピーされました!
SPIRE Agent のオペランドは、デフォルトで /metrics エンドポイントのポート 9402 でメトリクスを公開します。Prometheus Operator によるカスタムメトリクスの収集を可能にする ServiceMonitor カスタムリソース (CR) を作成することで、SPIRE Agent のメトリクス収集を設定できます。
前提条件
-
cluster-adminクラスターロールを持つユーザーとしてクラスターにアクセスできる。 - Zero Trust Workload Identity Manager がインストールされている。
- クラスターに SPIRE Agent のオペランドをデプロイしている。
- ユーザーワークロードモニタリングが有効になっている。
手順
ServiceMonitorCR を作成します。ServiceMonitorCR を定義する YAML ファイルを作成します。servicemonitor-spire-agent.yamlファイルの例Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して
ServiceMonitorCR を作成します。oc create -f servicemonitor-spire-agent.yaml
$ oc create -f servicemonitor-spire-agent.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow ServiceMonitorCR が作成されると、ユーザーワークロードの Prometheus インスタンスが、SPIRE エージェントからのメトリクス収集を開始します。収集されたメトリクスには、job="spire-agent"というラベルが付けられます。
検証
-
OpenShift Container Platform Web コンソールで、Observe
Targets に移動します。 Label フィルターフィールドに次のラベルを入力して、メトリクスターゲットをフィルタリングします。
service=spire-agent
$ service=spire-agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
spire-agent-metricsエントリーの Status 列にUpと表示されていることを確認します。
10.7.4. Zero Trust Workload Identity Manager のメトリクスの照会 リンクのコピーリンクがクリップボードにコピーされました!
クラスター管理者、またはすべての namespace に対する表示アクセス権を持つユーザーは、OpenShift Container Platform Web コンソールまたはコマンドラインを使用して、SPIRE Agent および SPIRE Server のメトリクスを照会できます。照会すると、指定したジョブラベルに一致する、SPIRE コンポーネントから収集されたすべてのメトリクスが取得されます。
前提条件
-
cluster-adminロールを持つユーザーとしてクラスターにアクセスできる。 - Zero Trust Workload Identity Manager がインストールされている。
- クラスターに SPIRE Server と SPIRE Agent のオペランドがデプロイされている。
-
ServiceMonitorオブジェクトを作成して、モニタリングとメトリクスの収集を有効化している。
手順
-
OpenShift Container Platform Web コンソールで、Observe
Metrics に移動します。 クエリーフィールドに次の PromQL 式を入力して、SPIRE Server のメトリクスを照会します。
{job="spire-server"}{job="spire-server"}Copy to Clipboard Copied! Toggle word wrap Toggle overflow クエリーフィールドに次の PromQL 式を入力して、SPIRE Agent のメトリクスを照会します。
{job="spire-agent"}{job="spire-agent"}Copy to Clipboard Copied! Toggle word wrap Toggle overflow