分散トレーシング

手順

1. Operators → OperatorHub に移動し、Tempo Operator を検索します。

2. Red Hat が提供 する Tempo Operator を選択します。

   重要

   次の選択は、この Operator のデフォルトのプリセットです。

   • Update channel → stable
   • Installation mode → All namespaces on the cluster
   • Installed Namespace → openshift-tempo-operator
   • Update approval → Automatic
3. Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択します。
4. Install → Install → View Operator を選択します。

手順

1. 以下のコマンドを実行して、Tempo Operator のプロジェクトを作成します。

   $ oc apply -f - << EOF
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     labels:
       kubernetes.io/metadata.name: openshift-tempo-operator
       openshift.io/cluster-monitoring: "true"
     name: openshift-tempo-operator
   EOF

   Copy to Clipboard Toggle word wrap

2. 以下のコマンドを実行して、Operator グループを作成します。

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-tempo-operator
     namespace: openshift-tempo-operator
   spec:
     upgradeStrategy: Default
   EOF

   Copy to Clipboard Toggle word wrap

3. 以下のコマンドを実行して、サブスクリプションを作成します。

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: tempo-product
     namespace: openshift-tempo-operator
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: tempo-product
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

   Copy to Clipboard Toggle word wrap

手順

1. AWS S3 バケットを作成します。

2. 次のステップで作成する AWS Identity and Access Management (AWS IAM) ロールと、TempoStack または TempoMonolithic インスタンスのいずれかのサービスアカウントとの間に信頼関係を設定するために、AWS IAM ポリシー用に次の trust.json ファイルを作成します。

   trust.json

   {
       "Version": "2012-10-17",
       "Statement": [
         {
           "Effect": "Allow",
           "Principal": {
             "Federated": "arn:aws:iam::<aws_account_id>:oidc-provider/<oidc_provider>" 

   1

   
           },
           "Action": "sts:AssumeRoleWithWebIdentity",
           "Condition": {
             "StringEquals": {
               "<oidc_provider>:sub": [
                 "system:serviceaccount:<openshift_project_for_tempo>:tempo-<tempo_custom_resource_name>" 

   2

   
                 "system:serviceaccount:<openshift_project_for_tempo>:tempo-<tempo_custom_resource_name>-query-frontend"
              ]
            }
          }
        }
       ]
   }

   Copy to Clipboard Toggle word wrap

   1

   OpenShift Container Platform で設定した OpenID Connect (OIDC) プロバイダー。

   2

   TempoStack または TempoMonolithic インスタンスのいずれかを作成する namespace。<tempo_custom_resource_name> は、TempoStack または TempoMonolithic カスタムリソースで定義する metadata 名に置き換えます。

   ヒント

   次のコマンドを実行して、OIDC プロバイダーの値を取得することもできます。

   $ oc get authentication cluster -o json | jq -r '.spec.serviceAccountIssuer' | sed 's~http[s]*://~~g'

   Copy to Clipboard Toggle word wrap

3. 作成した trust.json ポリシーファイルをアタッチして AWS IAM ロールを作成します。これを行うには、次のコマンドを実行します。

   $ aws iam create-role \
         --role-name "tempo-s3-access" \
         --assume-role-policy-document "file:///tmp/trust.json" \
         --query Role.Arn \
         --output text

   Copy to Clipboard Toggle word wrap

4. 作成した AWS IAM ロールに AWS IAM ポリシーをアタッチします。これを行うには、次のコマンドを実行します。

   $ aws iam attach-role-policy \
         --role-name "tempo-s3-access" \
         --policy-arn "arn:aws:iam::aws:policy/AmazonS3FullAccess"

   Copy to Clipboard Toggle word wrap

5. CCO を使用していない場合は、このステップをスキップしてください。CCO を使用している場合は、Tempo Operator のクラウドプロバイダー環境を設定します。これを行うには、次のコマンドを実行します。

   $ oc patch subscription <tempo_operator_sub> \ 

   1

   
             -n <tempo_operator_namespace> \ 

   2

   
             --type='merge' -p '{"spec": {"config": {"env": [{"name": "ROLEARN", "value": "'"<role_arn>"'"}]}}}' 

   3

   Copy to Clipboard Toggle word wrap

   1

   Tempo Operator サブスクリプションの名前。

   2

   Tempo Operator の namespace。

   3

   AWS STS では、Tempo Operator サブスクリプションに ROLEARN 環境変数を追加する必要があります。<role_arn> 値として、ステップ 3 で作成した AWS IAM ロールの Amazon Resource Name (ARN) を追加します。

6. OpenShift Container Platform で、次のように、キーを使用してオブジェクトストレージシークレットを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret_name>
   stringData:
     bucket: <s3_bucket_name>
     region: <s3_region>
     role_arn: <s3_role_arn>
   type: Opaque

   Copy to Clipboard Toggle word wrap

7. オブジェクトストレージシークレットが作成されたら、Distributed Tracing Platform インスタンスの関連するカスタムリソースを次のように更新します。

   TempoStack カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       secret: 

   1

   
         name: <secret_name>
         type: s3
         credentialMode: token-cco 

   2

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

   2

   CCO を使用していない場合は、この行を省略します。CCO を使用している場合は、token-cco 値とともにこのパラメーターを追加します。

   TempoMonolithic カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoMonolithic
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       traces:
         backend: s3
         s3:
           secret: <secret_name> 

   1

   
           credentialMode: token-cco 

   2

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

   2

   CCO を使用していない場合は、この行を省略します。CCO を使用している場合は、token-cco 値とともにこのパラメーターを追加します。

手順

1. 次のコマンドを実行して、Azure マネージドアイデンティティーを作成します。

   $ az identity create \
     --name <identity_name> \ 

   1

   
     --resource-group <resource_group> \ 

   2

   
     --location <region> \ 

   3

   
     --subscription <subscription_id> 

   4

   Copy to Clipboard Toggle word wrap

   1

   マネージドアイデンティティーに選択した名前。

   2

   アイデンティティーを作成する Azure リソースグループ。

   3

   Azure リージョン。リソースグループと同じリージョンである必要があります。

   4

   Azure サブスクリプション ID。

2. Query Frontend を除く Distributed Tracing Platform のすべてのコンポーネントで使用するために、OpenShift Container Platform サービスアカウントのフェデレーションアイデンティティー認証情報を作成します。これを行うには、次のコマンドを実行します。

   $ az identity federated-credential create \ 

   1

   
     --name <credential_name> \ 

   2

   
     --identity-name <identity_name> \
     --resource-group <resource_group> \
     --issuer <oidc_provider> \ 

   3

   
     --subject <tempo_service_account_subject> \ 

   4

   
     --audiences <audience> 

   5

   Copy to Clipboard Toggle word wrap

   1

   フェデレーションアイデンティティー認証情報を使用すると、OpenShift Container Platform サービスアカウントは、シークレットを保存したり、Azure サービスプリンシパルアイデンティティーを使用したりすることなく、Azure マネージドアイデンティティーとして認証できます。

   2

   フェデレーション認証情報に選択した名前。

   3

   クラスターの OpenID Connect (OIDC) プロバイダーの URL。

   4

   system:serviceaccount:<namespace>:tempo-<tempostack_instance_name> 形式のクラスターのサービスアカウントサブジェクト。

   5

   フェデレーションアイデンティティー認証情報に対して発行されたトークンを検証するために使用される、想定されるオーディエンス。これは通常、api://AzureADTokenExchange に設定されます。

   ヒント

   次のコマンドを実行すると、クラスターの OpenID Connect (OIDC) 発行者の URL を取得できます。

   $ oc get authentication cluster -o json | jq -r .spec.serviceAccountIssuer

   Copy to Clipboard Toggle word wrap

3. Distributed Tracing Platform の Query Frontend コンポーネントで使用するために、OpenShift Container Platform サービスアカウントのフェデレーションアイデンティティー認証情報を作成します。これを行うには、次のコマンドを実行します。

   $ az identity federated-credential create \ 

   1

   
     --name <credential_name>-frontend \ 

   2

   
     --identity-name <identity_name> \
     --resource-group <resource_group> \
     --issuer <cluster_issuer> \
     --subject <tempo_service_account_query_frontend_subject> \ 

   3

   
     --audiences <audience> | jq

   Copy to Clipboard Toggle word wrap

   1

   フェデレーションアイデンティティー認証情報を使用すると、OpenShift Container Platform サービスアカウントは、シークレットを保存したり、Azure サービスプリンシパルアイデンティティーを使用したりすることなく、Azure マネージドアイデンティティーとして認証できます。

   2

   フロントエンドフェデレーションアイデンティティー認証情報に選択した名前。

   3

   system:serviceaccount:<namespace>:tempo-<tempostack_instance_name> 形式のクラスターのサービスアカウントサブジェクト。

4. 作成された Azure マネージドアイデンティティーの Azure サービスプリンシパルアイデンティティーに、Storage Blob Data Contributor ロールを割り当てます。これを行うには、次のコマンドを実行します。

   $ az role assignment create \
     --assignee <assignee_name> \ 

   1

   
     --role "Storage Blob Data Contributor" \
     --scope "/subscriptions/<subscription_id>

   Copy to Clipboard Toggle word wrap

   1

   ステップ 1 で作成した Azure マネージドアイデンティティーの Azure サービスプリンシパルアイデンティティー。

   ヒント

   次のコマンドを実行すると、<assignee_name> の値を取得できます。

   $ az ad sp list --all --filter "servicePrincipalType eq 'ManagedIdentity'" | jq -r --arg idName <identity_name> '.[] | select(.displayName == $idName) | .appId'`

   Copy to Clipboard Toggle word wrap

5. ステップ 1 で作成した Azure マネージドアイデンティティーのクライアント ID を取得します。

   CLIENT_ID=$(az identity show \
     --name <identity_name> \ 

   1

   
     --resource-group <resource_group> \ 

   2

   
     --query clientId \
     -o tsv)

   Copy to Clipboard Toggle word wrap

   1

   ステップ 1 の <identity_name> 値をコピーして貼り付けます。

   2

   ステップ 1 の <resource_group> 値をコピーして貼り付けます。

6. Azure Workload Identity Federation (WIF) 用の OpenShift Container Platform シークレットを作成します。これを行うには、次のコマンドを実行します。

   $ oc create -n <tempo_namespace> secret generic azure-secret \
     --from-literal=container=<azure_storage_azure_container> \ 

   1

   
     --from-literal=account_name=<azure_storage_azure_accountname> \ 

   2

   
     --from-literal=client_id=<client_id> \ 

   3

   
     --from-literal=audience=<audience> \ 

   4

   
     --from-literal=tenant_id=<tenant_id> 

   5

   Copy to Clipboard Toggle word wrap

   1

   Azure Blob Storage コンテナーの名前。

   2

   Azure Storage アカウントの名前。

   3

   前のステップで取得したマネージドアイデンティティーのクライアント ID。

   4

   オプション: デフォルトは api://AzureADTokenExchange です。

   5

   Azure テナント ID。

7. オブジェクトストレージシークレットが作成されたら、Distributed Tracing Platform インスタンスの関連するカスタムリソースを次のように更新します。

   TempoStack カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       secret: 

   1

   
         name: <secret_name>
         type: azure
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

   TempoMonolithic カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoMonolithic
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       traces:
         backend: azure
         azure:
           secret: <secret_name> 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

手順

1. Google Cloud に GCS バケットを作成します。

2. Google の Identity and Access Management (IAM) を使用して、サービスアカウントを作成または再利用します。

   SERVICE_ACCOUNT_EMAIL=$(gcloud iam service-accounts create <iam_service_account_name> \ 

   1

   
       --display-name="Tempo Account" \
       --project <project_id>  \ 

   2

   
       --format='value(email)' \
       --quiet)

   Copy to Clipboard Toggle word wrap

   1

   Google Cloud 上のサービスアカウントの名前。

   2

   Google Cloud 上のサービスアカウントのプロジェクト ID。

3. 必要な Google Cloud ロールを、プロジェクトレベルで作成されたサービスアカウントにバインドします。これを行うには、次のコマンドを実行します。

   $ gcloud projects add-iam-policy-binding <project_id> \
       --member "serviceAccount:$SERVICE_ACCOUNT_EMAIL" \
       --role "roles/storage.objectAdmin"

   Copy to Clipboard Toggle word wrap

4. クラスターに関連付けられている Google Cloud Workload Identity Pool の POOL_ID 値を取得します。この値を取得する方法は環境によって異なるため、次のコマンドは単なる例です。

   $ OIDC_ISSUER=$(oc get authentication.config cluster -o jsonpath='{.spec.serviceAccountIssuer}') \
   &&
     POOL_ID=$(echo "$OIDC_ISSUER" | awk -F'/' '{print $NF}' | sed 's/-oidc$//')

   Copy to Clipboard Toggle word wrap

5. IAM ポリシーバインディングを追加します。これを行うには、次のコマンドを実行します。

   $ gcloud iam service-accounts add-iam-policy-binding "$SERVICE_ACCOUNT_EMAIL" \ 

   1

   
     --role="roles/iam.workloadIdentityUser" \
     --member="principal://iam.googleapis.com/projects/<project_number>/locations/global/workloadIdentityPools/<pool_id>/subject/system:serviceaccount:<tempo_namespace>:tempo-<tempo_name>" \
     --project=<project_id> \
     --quiet \
   &&
     gcloud iam service-accounts add-iam-policy-binding "$SERVICE_ACCOUNT_EMAIL" \
     --role="roles/iam.workloadIdentityUser" \
     --member="principal://iam.googleapis.com/projects/<project_number>/locations/global/workloadIdentityPools/<pool_id>/subject/system:serviceaccount:<tempo_namespace>:tempo-<tempo_name>-query-frontend" \
     --project=<project_id> \
     --quiet
   &&
     gcloud storage buckets add-iam-policy-binding "gs://$BUCKET_NAME" \
     --role="roles/storage.admin" \
     --member="serviceAccount:$SERVICE_ACCOUNT_EMAIL" \
     --condition=None

   Copy to Clipboard Toggle word wrap

   1

   $SERVICE_ACCOUNT_EMAIL は、ステップ 2 のコマンドの出力です。

6. TempoStack カスタムリソースで使用するストレージシークレットの key.json キーの認証情報ファイルを作成します。これを行うには、次のコマンドを実行します。

   $ gcloud iam workload-identity-pools create-cred-config \
       "projects/<project_number>/locations/global/workloadIdentityPools/<pool_id>/providers/<provider_id>" \
       --service-account="$SERVICE_ACCOUNT_EMAIL" \
       --credential-source-file=/var/run/secrets/storage/serviceaccount/token \ 

   1

   
       --credential-source-type=text \
       --output-file=<output_file_path> 

   2

   Copy to Clipboard Toggle word wrap

   1

   Operator はこのパスからトークンをマウントするため、credential-source-file パラメーターは常に /var/run/secrets/storage/serviceaccount/token パスを指している必要があります。

   2

   出力ファイルを保存するためのパス。

7. 次のコマンドを実行して、正しいオーディエンスを取得します。

   $ gcloud iam workload-identity-pools providers describe "$PROVIDER_NAME" --format='value(oidc.allowedAudiences[0])'

   Copy to Clipboard Toggle word wrap

8. 次のコマンドを実行して、Distributed Tracing Platform のストレージシークレットを作成します。

   $ oc -n <tempo_namespace> create secret generic gcs-secret \
     --from-literal=bucketname="<bucket_name>" \ 

   1

   
     --from-literal=audience="<audience>" \      

   2

   
     --from-file=key.json=<output_file_path>    

   3

   Copy to Clipboard Toggle word wrap

   1

   Google Cloud Storage のバケット名。

   2

   前のステップで取得したオーディエンス。

   3

   ステップ 6 で作成した認証情報ファイル。

9. オブジェクトストレージシークレットが作成されたら、Distributed Tracing Platform インスタンスの関連するカスタムリソースを次のように更新します。

   TempoStack カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       secret: 

   1

   
         name: <secret_name>
         type: gcs
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

   TempoMonolithic カスタムリソースの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoMonolithic
   metadata:
     name: <name>
     namespace: <namespace>
   spec:
   # ...
     storage:
       traces:
         backend: gcs
         gcs:
           secret: <secret_name> 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したシークレット。

手順

1. IBM Cloud でオブジェクトストアバケットを作成します。

2. IBM Cloud で、次のコマンドを実行して、オブジェクトストアバケットに接続するためのサービスキーを作成します。

   $ ibmcloud resource service-key-create <tempo_bucket> Writer \
     --instance-name <tempo_bucket> --parameters '{"HMAC":true}'

   Copy to Clipboard Toggle word wrap

3. IBM Cloud で、次のコマンドを実行して、バケット認証情報を含むシークレットを作成します。

   $ oc -n <namespace> create secret generic <ibm_cos_secret> \
     --from-literal=bucket="<tempo_bucket>" \
     --from-literal=endpoint="<ibm_bucket_endpoint>" \
     --from-literal=access_key_id="<ibm_bucket_access_key>" \
     --from-literal=access_key_secret="<ibm_bucket_secret_key>"

   Copy to Clipboard Toggle word wrap

4. OpenShift Container Platform で、次のように、キーを使用してオブジェクトストレージシークレットを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: <ibm_cos_secret>
   stringData:
     bucket: <tempo_bucket>
     endpoint: <ibm_bucket_endpoint>
     access_key_id: <ibm_bucket_access_key>
     access_key_secret: <ibm_bucket_secret_key>
   type: Opaque

   Copy to Clipboard Toggle word wrap

5. OpenShift Container Platform で、TempoStack カスタムリソースのストレージセクションを次のように設定します。

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   # ...
   spec:
   # ...
     storage:
       secret:
         name: <ibm_cos_secret> 

   1

   
         type: s3
   # ...

   Copy to Clipboard Toggle word wrap

   1

   IBM Cloud Storage のアクセスキーとシークレットキーが含まれるシークレットの名前。

手順

1. 任意の値を指定した tenantName および tenantId パラメーターを TempoStack カスタムリソース (CR) に追加して、テナントを定義します。

   TempoStack CR のテナントの例

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: redmetrics
   spec:
   # ...
     tenants:
       mode: openshift
       authentication:
         - tenantName: dev 

   1

   
           tenantId: "1610b0c3-c509-4592-a256-a1871353dbfa" 

   2

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   ユーザーが選択した tenantName 値。

   2

   ユーザーが選択した tenantId 値。

2. トレースを読み取るための読み取り (get) 権限を持つクラスターロールにテナントを追加します。

   ClusterRole リソースの RBAC 設定の例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: tempostack-traces-reader
   rules:
     - apiGroups:
         - 'tempo.grafana.com'
       resources: 

   1

   
         - dev
         - prod
       resourceNames:
         - traces
       verbs:
         - 'get' 

   2

   Copy to Clipboard Toggle word wrap

   1

   この例では、前のステップで tenantName パラメーターを使用して定義したテナント (dev および prod) をリストします。

   2

   リストしたテナントの読み取り操作を有効にします。

3. 上記ステップのクラスターロールのクラスターロールバインディングを定義して、認証されたユーザーにトレースデータの読み取り権限を付与します。

   ClusterRoleBinding リソースの RBAC 設定の例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: tempostack-traces-reader
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: tempostack-traces-reader
   subjects:
     - kind: Group
       apiGroup: rbac.authorization.k8s.io
       name: system:authenticated 

   1

   Copy to Clipboard Toggle word wrap

   1

   認証されたユーザー全員に、トレースデータの読み取り権限を付与します。

手順

1. OpenTelemetry Collector で使用するためのサービスアカウントを作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector
     namespace: <project_of_opentelemetry_collector_instance>

   Copy to Clipboard Toggle word wrap

2. トレースを書き込むための書き込み (create) 権限を持つクラスターロールにテナントを追加します。

   ClusterRole リソースの RBAC 設定の例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: tempostack-traces-write
   rules:
     - apiGroups:
         - 'tempo.grafana.com'
       resources: 

   1

   
         - dev
       resourceNames:
         - traces
       verbs:
         - 'create' 

   2

   Copy to Clipboard Toggle word wrap

   1

   テナントをリスト表示します。

   2

   書き込み操作を有効にします。

3. OpenTelemetry Collector のサービスアカウントを割り当てるためのクラスターロールバインディングを定義して、OpenTelemetry Collector に書き込み権限を付与します。

   ClusterRoleBinding リソースの RBAC 設定の例

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: tempostack-traces
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: tempostack-traces-write
   subjects:
     - kind: ServiceAccount
       name: otel-collector 

   1

   
       namespace: otel

   Copy to Clipboard Toggle word wrap

   1

   前のステップで作成したサービスアカウント。これは、クライアントがトレースデータをエクスポートするときに使用されます。

4. OpenTelemetryCollector カスタムリソースを次のように設定します。

   • トレーシングパイプラインサービスに、bearertokenauth エクステンションと有効なトークンを追加します。
   • otlp/otlphttp エクスポーターにテナント名を X-Scope-OrgID ヘッダーとして追加します。

   • 有効な認証局ファイルを使用して TLS を有効にします。

     OpenTelemetry CR 設定のサンプル

     apiVersion: opentelemetry.io/v1beta1
     kind: OpenTelemetryCollector
     metadata:
       name: cluster-collector
       namespace: <project_of_tempostack_instance>
     spec:
       mode: deployment
       serviceAccount: otel-collector 

     1

     
       config: |
           extensions:
             bearertokenauth: 

     2

     
               filename: "/var/run/secrets/kubernetes.io/serviceaccount/token" 

     3

     
           exporters:
             otlp/dev: 

     4

     
               endpoint: sample-gateway.tempo.svc.cluster.local:8090
               tls:
                 insecure: false
                 ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt" 

     5

     
               auth:
                 authenticator: bearertokenauth
               headers:
                 X-Scope-OrgID: "dev" 

     6

     
             otlphttp/dev: 

     7

     
               endpoint: https://sample-gateway.<project_of_tempostack_instance>.svc.cluster.local:8080/api/traces/v1/dev
               tls:
                 insecure: false
                 ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt"
               auth:
                 authenticator: bearertokenauth
               headers:
                 X-Scope-OrgID: "dev"
           service:
             extensions: [bearertokenauth]
             pipelines:
               traces:
                 exporters: [otlp/dev] 

     8

     
     
     # ...

     Copy to Clipboard Toggle word wrap

     1

     書き込み権限が設定されたサービスアカウント。

     2

     サービスアカウントトークンを使用するためのベアラートークンエクステンション。

     3

     サービスアカウントトークン。このトークンは、ベアラートークンヘッダーとして、クライアントによりトレーシングパイプラインサービスに送信されます。

     4

     OTLP gRPC Exporter (otlp/dev) または OTLP HTTP Exporter (otlphttp/dev) のいずれかを指定します。

     5

     有効なサービス CA ファイルを使用して TLS を有効にします。

     6

     テナント名を含むヘッダー。

     7

     OTLP gRPC Exporter (otlp/dev) または OTLP HTTP Exporter (otlphttp/dev) のいずれかを指定します。

     8

     CR の exporters セクションで指定したエクスポーター。

手順

1. Home → Projects → Create Project に移動して、後続のステップで作成する TempoStack インスタンス用に、許可される任意のプロジェクトを作成します。openshift- 接頭辞で始まるプロジェクト名は許可されません。

2. Workloads → Secrets → Create → From YAML に移動して、TempoStack インスタンス用に作成したプロジェクトに、オブジェクトストレージバケットのシークレットを作成します。詳細は、「オブジェクトストレージのセットアップ」を参照してください。

   Amazon S3 および MinIO ストレージのシークレット例

   apiVersion: v1
   kind: Secret
   metadata:
     name: minio-test
   stringData:
     endpoint: http://minio.minio.svc:9000
     bucket: tempo
     access_key_id: tempo
     access_key_secret: <secret>
   type: Opaque

   Copy to Clipboard Toggle word wrap

3. TempoStack インスタンスを作成します。

   注記

   同じクラスター上の別々のプロジェクトに、複数の TempoStack インスタンスを作成できます。

   1. Operators → Installed Operators に移動します。
   2. TempoStack → Create TempoStack → YAML view の順に選択します。

   3. YAML view で、TempoStack カスタムリソース (CR) をカスタマイズします。

      AWS S3 および MinIO ストレージと 2 つのテナント用の TempoStack CR の例

      apiVersion: tempo.grafana.com/v1alpha1
      kind: TempoStack 

      1

      
      metadata:
        name: simplest
        namespace: <permitted_project_of_tempostack_instance> 

      2

      
      spec: 

      3

      
        storage: 

      4

      
          secret: 

      5

      
            name: <secret_name> 

      6

      
            type: <secret_provider> 

      7

      
        storageSize: <value>Gi 

      8

      
        resources: 

      9

      
          total:
            limits:
              memory: 2Gi
              cpu: 2000m
        tenants:
          mode: openshift 

      10

      
          authentication: 

      11

      
            - tenantName: dev 

      12

      
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfa" 

      13

      
            - tenantName: prod
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfb"
        template:
          gateway:
            enabled: true 

      14

      
          queryFrontend:
            jaegerQuery:
              enabled: true 

      15

      Copy to Clipboard Toggle word wrap

      1

      この CR は、HTTP および OpenTelemetry Protocol (OTLP) 経由で Jaeger Thrift を受信するように設定された TempoStack デプロイメントを作成します。

      2

      TempoStack デプロイメント用に選択したプロジェクト。openshift- 接頭辞で始まるプロジェクト名は許可されません。

      3

      Red Hat は、Red Hat OpenShift Distributed Tracing Platform ドキュメントに記載されているカスタムリソースオプションのみをサポートしています。

      4

      トレースを保存するためのストレージを指定します。

      5

      前提条件の 1 つとして設定したオブジェクトストレージ用に、ステップ 2 で作成したシークレット。

      6

      シークレットの metadata セクションにある name フィールドの値。たとえば、minio です。

      7

      この値には、Azure Blob Storage の場合は azure、Google Cloud Storage の場合は gcs、Amazon S3、MinIO、または Red Hat OpenShift Data Foundation の場合は s3 を使用できます。たとえば、s3 です。

      8

      Tempo Write-Ahead Logging (WAL) の永続ボリューム要求のサイズ。デフォルトは 10Gi です。たとえば、1Gi のように指定します。

      9

      任意。

      10

      値は openshift である必要があります。

      11

      テナントのリスト。

      12

      テナント名。X-Scope-OrgId HTTP ヘッダーの値として使用されます。

      13

      テナントの一意の識別子。TempoStack デプロイメントのライフサイクル全体を通じて一意である必要があります。Distributed Tracing Platform は、この ID を使用して、オブジェクトストレージ内のオブジェクトに接頭辞を付けます。UUID または tempoName フィールドの値を再利用できます。

      14

      認証と認可を実行するゲートウェイを有効にします。

      15

      http://<gateway_ingress>/api/traces/v1/<tenant_name>/search のルート経由で、データを視覚化する Jaeger UI を公開します。

   4. Create を選択します。

検証

1. Project: ドロップダウンリストを使用して、TempoStack インスタンスのプロジェクトを選択します。
2. Operators → Installed Operators に移動して、TempoStack インスタンスの Status が Condition: Ready であることを確認します。
3. Workloads → Pods に移動して、TempoStack インスタンスのすべてのコンポーネント Pod が稼働していることを確認します。

4. Tempo コンソールにアクセスします。

   1. Networking → Routes に移動し、Ctrl+F で tempo を検索します。

   2. Location 列で URL を開き、Tempo コンソールにアクセスします。

      注記

      Tempo コンソールをインストールした直後は、Tempo コンソールにトレースデータは表示されません。

手順

1. 次のコマンドを実行して、後続のステップで作成する TempoStack インスタンス用に、許可される任意のプロジェクトを作成します。

   $ oc apply -f - << EOF
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: <permitted_project_of_tempostack_instance> 

   1

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   openshift- 接頭辞で始まるプロジェクト名は許可されません。

2. TempoStack インスタンス用に作成したプロジェクトで、次のコマンドを実行して、オブジェクトストレージバケットのシークレットを作成します。

   $ oc apply -f - << EOF
   <object_storage_secret>
   EOF

   Copy to Clipboard Toggle word wrap

   詳細は、「オブジェクトストレージのセットアップ」を参照してください。

   Amazon S3 および MinIO ストレージのシークレット例

   apiVersion: v1
   kind: Secret
   metadata:
     name: minio-test
   stringData:
     endpoint: http://minio.minio.svc:9000
     bucket: tempo
     access_key_id: tempo
     access_key_secret: <secret>
   type: Opaque

   Copy to Clipboard Toggle word wrap

3. TempoStack インスタンス用に作成したプロジェクトに TempoStack インスタンスを作成します。

   注記

   同じクラスター上の別々のプロジェクトに、複数の TempoStack インスタンスを作成できます。

   1. TempoStack カスタムリソース (CR) をカスタマイズします。

      AWS S3 および MinIO ストレージと 2 つのテナント用の TempoStack CR の例

      apiVersion: tempo.grafana.com/v1alpha1
      kind: TempoStack 

      1

      
      metadata:
        name: simplest
        namespace: <permitted_project_of_tempostack_instance> 

      2

      
      spec: 

      3

      
        storage: 

      4

      
          secret: 

      5

      
            name: <secret_name> 

      6

      
            type: <secret_provider> 

      7

      
        storageSize: <value>Gi 

      8

      
        resources: 

      9

      
          total:
            limits:
              memory: 2Gi
              cpu: 2000m
        tenants:
          mode: openshift 

      10

      
          authentication: 

      11

      
            - tenantName: dev 

      12

      
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfa" 

      13

      
            - tenantName: prod
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfb"
        template:
          gateway:
            enabled: true 

      14

      
          queryFrontend:
            jaegerQuery:
              enabled: true 

      15

      Copy to Clipboard Toggle word wrap

      1

      この CR は、HTTP および OpenTelemetry Protocol (OTLP) 経由で Jaeger Thrift を受信するように設定された TempoStack デプロイメントを作成します。

      2

      TempoStack デプロイメント用に選択したプロジェクト。openshift- 接頭辞で始まるプロジェクト名は許可されません。

      3

      Red Hat は、Red Hat OpenShift Distributed Tracing Platform ドキュメントに記載されているカスタムリソースオプションのみをサポートしています。

      4

      トレースを保存するためのストレージを指定します。

      5

      前提条件の 1 つとして設定したオブジェクトストレージ用に、ステップ 2 で作成したシークレット。

      6

      シークレットの metadata セクションにある name フィールドの値。たとえば、minio です。

      7

      この値には、Azure Blob Storage の場合は azure、Google Cloud Storage の場合は gcs、Amazon S3、MinIO、または Red Hat OpenShift Data Foundation の場合は s3 を使用できます。たとえば、s3 です。

      8

      Tempo Write-Ahead Logging (WAL) の永続ボリューム要求のサイズ。デフォルトは 10Gi です。たとえば、1Gi のように指定します。

      9

      任意。

      10

      値は openshift である必要があります。

      11

      テナントのリスト。

      12

      テナント名。X-Scope-OrgId HTTP ヘッダーの値として使用されます。

      13

      テナントの一意の識別子。TempoStack デプロイメントのライフサイクル全体を通じて一意である必要があります。Distributed Tracing Platform は、この ID を使用して、オブジェクトストレージ内のオブジェクトに接頭辞を付けます。UUID または tempoName フィールドの値を再利用できます。

      14

      認証と認可を実行するゲートウェイを有効にします。

      15

      http://<gateway_ingress>/api/traces/v1/<tenant_name>/search のルート経由で、データを視覚化する Jaeger UI を公開します。

   2. 次のコマンドを実行して、カスタマイズされた CR を適用します。

      $ oc apply -f - << EOF
      <tempostack_cr>
      EOF

      Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、すべての TempoStack components の status が Running、conditions が type: Ready になっていることを確認します。

   $ oc get tempostacks.tempo.grafana.com simplest -o yaml

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、すべての TempoStack コンポーネント Pod が稼働していることを確認します。

   $ oc get pods

   Copy to Clipboard Toggle word wrap

3. Tempo コンソールにアクセスします。

   1. 以下のコマンドを実行してルートの詳細をクエリーします。

      $ oc get route

      Copy to Clipboard Toggle word wrap

   2. Web ブラウザーで https://<route_from_previous_step> を開きます。

      注記

      Tempo コンソールをインストールした直後は、Tempo コンソールにトレースデータは表示されません。

手順

1. Home → Projects → Create Project に移動して、後続のステップで作成する TempoMonolithic インスタンス用に、許可される任意のプロジェクトを作成します。openshift- 接頭辞で始まるプロジェクト名は許可されません。

2. トレースの保存に使用するサポート対象のストレージのタイプ (インメモリーストレージ、永続ボリューム、オブジェクトストレージ) を決定します。

   重要

   オブジェクトストレージは、Distributed Tracing Platform には含まれていません。そのため、サポートされているプロバイダー (Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、または Google Cloud Storage) によるオブジェクトストアを設定する必要があります。

   また、オブジェクトストレージを選択するには、TempoMonolithic インスタンス用に作成したプロジェクトにオブジェクトストレージバケットのシークレットを作成する必要があります。これは、Workloads → Secrets → Create → From YAML で実行できます。

   詳細は、「オブジェクトストレージのセットアップ」を参照してください。

   Amazon S3 および MinIO ストレージのシークレット例

   apiVersion: v1
   kind: Secret
   metadata:
     name: minio-test
   stringData:
     endpoint: http://minio.minio.svc:9000
     bucket: tempo
     access_key_id: tempo
     access_key_secret: <secret>
   type: Opaque

   Copy to Clipboard Toggle word wrap

3. TempoMonolithic インスタンスを作成します。

   注記

   同じクラスター上の別々のプロジェクトに複数の TempoMonolithic インスタンスを作成できます。

   1. Operators → Installed Operators に移動します。
   2. TempoMonolithic → Create TempoMonolithic → YAML view を選択します。

   3. YAML view で、TempoMonolithic カスタムリソース (CR) をカスタマイズします。

      TempoMonolithic CR の例

      apiVersion: tempo.grafana.com/v1alpha1
      kind: TempoMonolithic 

      1

      
      metadata:
        name: <metadata_name>
        namespace: <permitted_project_of_tempomonolithic_instance> 

      2

      
      spec: 

      3

      
        storage: 

      4

      
          traces:
            backend: <supported_storage_type> 

      5

      
            size: <value>Gi 

      6

      
            s3: 

      7

      
              secret: <secret_name> 

      8

      
          tls: 

      9

      
            enabled: true
            caName: <ca_certificate_configmap_name> 

      10

      
        jaegerui:
          enabled: true 

      11

      
          route:
            enabled: true 

      12

      
        resources: 

      13

      
          total:
            limits:
              memory: <value>Gi
              cpu: <value>m
        multitenancy:
          enabled: true
          mode: openshift
          authentication: 

      14

      
            - tenantName: dev 

      15

      
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfa" 

      16

      
            - tenantName: prod
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfb"

      Copy to Clipboard Toggle word wrap

      1

      この CR は、OTLP プロトコルでトレースの取り込みを行う TempoMonolithic デプロイメントを作成します。

      2

      TempoMonolithic デプロイメント用に選択したプロジェクト。openshift- 接頭辞で始まるプロジェクト名は許可されません。

      3

      Red Hat は、Red Hat OpenShift Distributed Tracing Platform ドキュメントに記載されているカスタムリソースオプションのみをサポートしています。

      4

      トレースを保存するためのストレージを指定します。

      5

      トレースを保存するストレージのタイプ (インメモリーストレージ、永続ボリューム、またはオブジェクトストレージ)。永続ボリュームの値は pv です。オブジェクトストレージの値は、使用するオブジェクトストアのタイプに応じて、s3、gcs、または azure が受け入れられます。デフォルト値は、tmpfs インメモリーストレージの memory です。これは、Pod がシャットダウンするとデータが保持されないため、開発、テスト、デモ、および概念検証用の環境にのみ適しています。

      6

      メモリーサイズ: インメモリーストレージの場合、これは tmpfs ボリュームのサイズを意味します。デフォルトは 2Gi です。永続ボリュームの場合、これは永続ボリューム要求のサイズを意味します。デフォルトは 10Gi です。オブジェクトストレージの場合、これは Tempo Write-Ahead Logging (WAL) の永続ボリューム要求のサイズを意味し、デフォルトは 10Gi です。

      7

      オプション: オブジェクトストレージの場合、オブジェクトストレージのタイプ。使用するオブジェクトストアのタイプに応じて、s3、gcs、および azure が値として受け入れられます。

      8

      オプション: オブジェクトストレージの場合、ストレージシークレットの metadata 内の name の値。ストレージシークレットは、TempoMonolithic インスタンスと同じ namespace にあり、「表 1.必要なシークレットパラメーター」(「オブジェクトストレージのセットアップ」セクションを参照) で指定えているフィールドを含んでいる必要があります。

      9

      オプション:

      10

      オプション: CA 証明書を含む ConfigMap オブジェクトの名前。

      11

      http://<gateway_ingress>/api/traces/v1/<tenant_name>/search のルート経由で、データを視覚化する Jaeger UI を公開します。

      12

      Jaeger UI のルートの作成を有効にします。

      13

      任意。

      14

      テナントをリスト表示します。

      15

      テナント名。X-Scope-OrgId HTTP ヘッダーの値として使用されます。

      16

      テナントの一意の識別子。TempoMonolithic デプロイメントのライフサイクル全体を通じて一意である必要があります。この ID は、オブジェクトストレージ内のオブジェクトの接頭辞として追加されます。UUID または tempoName フィールドの値を再利用できます。

   4. Create を選択します。

検証

1. Project: ドロップダウンリストを使用して、TempoMonolithic インスタンスのプロジェクトを選択します。
2. Operator → Installed Operator に移動して、TempoMonolithic インスタンスの Status が Condition: Ready であることを確認します。
3. Workloads → Pod に移動して、TempoMonolithic インスタンスの Pod が実行中であることを確認します。

4. Jaeger UI にアクセスします。

   1. Networking → Routes に移動し、Ctrl+F を押して jaegerui を検索します。

      注記

      Jaeger UI は、tempo-<metadata_name_of_TempoMonolithic_CR>-jaegerui ルートを使用します。

   2. Location 列で URL を開き、Jaeger UI にアクセスします。

5. TempoMonolithic インスタンスの Pod の準備ができたら、クラスター内の tempo-<metadata_name_of_TempoMonolithic_CR>:4317 (OTLP/gRPC) および tempo-<metadata_name_of_TempoMonolithic_CR>:4318 (OTLP/HTTP) エンドポイントにトレースを送信できます。

   Tempo API は、クラスター内の tempo-<metadata_name_of_TempoMonolithic_CR>:3200 エンドポイントで利用できます。

手順

1. 次のコマンドを実行して、後続のステップで作成する TempoMonolithic インスタンス用に、許可される任意のプロジェクトを作成します。

   $ oc apply -f - << EOF
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: <permitted_project_of_tempomonolithic_instance> 

   1

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   openshift- 接頭辞で始まるプロジェクト名は許可されません。

2. トレースの保存に使用するサポート対象のストレージのタイプ (インメモリーストレージ、永続ボリューム、オブジェクトストレージ) を決定します。

   重要

   オブジェクトストレージは、Distributed Tracing Platform には含まれていません。そのため、サポートされているプロバイダー (Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、または Google Cloud Storage) によるオブジェクトストアを設定する必要があります。

   また、オブジェクトストレージを選択するには、TempoMonolithic インスタンス用に作成したプロジェクトにオブジェクトストレージバケットのシークレットを作成する必要があります。これを行うには、次のコマンドを実行します。

   $ oc apply -f - << EOF
   <object_storage_secret>
   EOF

   Copy to Clipboard Toggle word wrap

   詳細は、「オブジェクトストレージのセットアップ」を参照してください。

   Amazon S3 および MinIO ストレージのシークレット例

   apiVersion: v1
   kind: Secret
   metadata:
     name: minio-test
   stringData:
     endpoint: http://minio.minio.svc:9000
     bucket: tempo
     access_key_id: tempo
     access_key_secret: <secret>
   type: Opaque

   Copy to Clipboard Toggle word wrap

3. TempoMonolithic インスタンス用に作成したプロジェクト内に TempoMonolithic インスタンスを作成します。

   ヒント

   同じクラスター上の別々のプロジェクトに複数の TempoMonolithic インスタンスを作成できます。

   1. TempoMonolithic カスタムリソース (CR) をカスタマイズします。

      TempoMonolithic CR の例

      apiVersion: tempo.grafana.com/v1alpha1
      kind: TempoMonolithic 

      1

      
      metadata:
        name: <metadata_name>
        namespace: <permitted_project_of_tempomonolithic_instance> 

      2

      
      spec: 

      3

      
        storage: 

      4

      
          traces:
            backend: <supported_storage_type> 

      5

      
            size: <value>Gi 

      6

      
            s3: 

      7

      
              secret: <secret_name> 

      8

      
          tls: 

      9

      
            enabled: true
            caName: <ca_certificate_configmap_name> 

      10

      
        jaegerui:
          enabled: true 

      11

      
          route:
            enabled: true 

      12

      
        resources: 

      13

      
          total:
            limits:
              memory: <value>Gi
              cpu: <value>m
        multitenancy:
          enabled: true
          mode: openshift
          authentication: 

      14

      
            - tenantName: dev 

      15

      
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfa" 

      16

      
            - tenantName: prod
              tenantId: "1610b0c3-c509-4592-a256-a1871353dbfb"

      Copy to Clipboard Toggle word wrap

      1

      この CR は、OTLP プロトコルでトレースの取り込みを行う TempoMonolithic デプロイメントを作成します。

      2

      TempoMonolithic デプロイメント用に選択したプロジェクト。openshift- 接頭辞で始まるプロジェクト名は許可されません。

      3

      Red Hat は、Red Hat OpenShift Distributed Tracing Platform ドキュメントに記載されているカスタムリソースオプションのみをサポートしています。

      4

      トレースを保存するためのストレージを指定します。

      5

      トレースを保存するストレージのタイプ (インメモリーストレージ、永続ボリューム、またはオブジェクトストレージ)。永続ボリュームの値は pv です。オブジェクトストレージの値は、使用するオブジェクトストアのタイプに応じて、s3、gcs、または azure が受け入れられます。デフォルト値は、tmpfs インメモリーストレージの memory です。これは、Pod がシャットダウンするとデータが保持されないため、開発、テスト、デモ、および概念検証用の環境にのみ適しています。

      6

      メモリーサイズ: インメモリーストレージの場合、これは tmpfs ボリュームのサイズを意味します。デフォルトは 2Gi です。永続ボリュームの場合、これは永続ボリューム要求のサイズを意味します。デフォルトは 10Gi です。オブジェクトストレージの場合、これは Tempo Write-Ahead Logging (WAL) の永続ボリューム要求のサイズを意味し、デフォルトは 10Gi です。

      7

      オプション: オブジェクトストレージの場合、オブジェクトストレージのタイプ。使用するオブジェクトストアのタイプに応じて、s3、gcs、および azure が値として受け入れられます。

      8

      オプション: オブジェクトストレージの場合、ストレージシークレットの metadata 内の name の値。ストレージシークレットは、TempoMonolithic インスタンスと同じ namespace にあり、「表 1.必要なシークレットパラメーター」(「オブジェクトストレージのセットアップ」セクションを参照) で指定えているフィールドを含んでいる必要があります。

      9

      オプション:

      10

      オプション: CA 証明書を含む ConfigMap オブジェクトの名前。

      11

      http://<gateway_ingress>/api/traces/v1/<tenant_name>/search のルート経由で、データを視覚化する Jaeger UI を公開します。

      12

      Jaeger UI のルートの作成を有効にします。

      13

      任意。

      14

      テナントをリスト表示します。

      15

      テナント名。X-Scope-OrgId HTTP ヘッダーの値として使用されます。

      16

      テナントの一意の識別子。TempoMonolithic デプロイメントのライフサイクル全体を通じて一意である必要があります。この ID は、オブジェクトストレージ内のオブジェクトの接頭辞として追加されます。UUID または tempoName フィールドの値を再利用できます。

   2. 次のコマンドを実行して、カスタマイズされた CR を適用します。

      $ oc apply -f - << EOF
      <tempomonolithic_cr>
      EOF

      Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、すべての TempoMonolithic components の status が Running であり、conditions が type: Ready であることを確認します。

   $ oc get tempomonolithic.tempo.grafana.com <metadata_name_of_tempomonolithic_cr> -o yaml

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、TempoMonolithic インスタンスの Pod が実行中であることを確認します。

   $ oc get pods

   Copy to Clipboard Toggle word wrap

3. Jaeger UI にアクセスします。

   1. 次のコマンドを実行して、tempo-<metadata_name_of_tempomonolithic_cr>-jaegerui ルートのルート詳細をクエリーします。

      $ oc get route

      Copy to Clipboard Toggle word wrap
   2. Web ブラウザーで https://<route_from_previous_step> を開きます。

4. TempoMonolithic インスタンスの Pod の準備ができたら、クラスター内の tempo-<metadata_name_of_tempomonolithic_cr>:4317 (OTLP/gRPC) および tempo-<metadata_name_of_tempomonolithic_cr>:4318 (OTLP/HTTP) エンドポイントにトレースを送信できます。

   Tempo API は、クラスター内の tempo-<metadata_name_of_tempomonolithic_cr>:3200 エンドポイントで利用できます。

手順

1. TempoStack インスタンスのメトリクスを有効にするには、spec.observability.metrics.createServiceMonitors フィールドを true に設定します。

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: <name>
   spec:
     observability:
       metrics:
         createServiceMonitors: true

   Copy to Clipboard Toggle word wrap

2. TempoStack インスタンスのアラートを有効にするには、spec.observability.metrics.createPrometheusRules フィールドを true に設定します。

   apiVersion: tempo.grafana.com/v1alpha1
   kind: TempoStack
   metadata:
     name: <name>
   spec:
     observability:
       metrics:
         createPrometheusRules: true

   Copy to Clipboard Toggle word wrap