분산 추적

프로세스

1. Operators → OperatorHub 로 이동하여 Tempo Operator 를 검색합니다.

2. Red Hat에서 제공하는 Tempo Operator를 선택하세요.

   중요

   다음 선택 사항은 이 연산자에 대한 기본 사전 설정입니다.

   • 업데이트 채널 → stable
   • 설치 모드 → 클러스터의 모든 네임스페이스
   • 설치된 네임스페이스 → openshift-tempo-operator
   • 업데이트 승인 → 자동
3. 이 네임스페이스에서 운영자가 권장하는 클러스터 모니터링을 활성화하는 옵션을 선택합니다.
4. 설치 → 설치 → 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. 다음 명령을 실행하여 운영자 그룹을 만듭니다.

   $ 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 IAM 역할과 TempoStack 또는 TempoMonolithic 인스턴스의 서비스 계정 간에 신뢰 관계(trust relationship)를 설정하기 위해, AWS Identity and Access Management (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 인스턴스를 생성하려는 네임스페이스입니다. <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의 네임스페이스입니다.

   3

   AWS STS에서는 Tempo Operator 서브스크립션에 ROLEARN 환경 변수를 추가해야 합니다. <role_arn> 값으로 3단계에서 생성한 AWS IAM 역할의 Amazon 리소스 이름(ARN)을 추가합니다.

6. OpenShift 컨테이너 플랫폼에서 다음과 같이 키를 사용하여 개체 저장소 비밀을 만듭니다.

   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 관리 ID를 만듭니다.

   $ 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

   관리되는 ID에 대해 선택한 이름입니다.

   2

   ID를 만들려는 Azure 리소스 그룹입니다.

   3

   Azure 지역은 리소스 그룹과 동일한 지역이어야 합니다.

   4

   Azure 서브스크립션 ID입니다.

2. Query Frontend를 제외한 Distributed Tracing Platform의 모든 컴포넌트에서 사용할 수 있도록, OpenShift Container Platform 서비스 계정에 대한 페더레이션 ID 자격 증명을 생성하십시오. 다음 명령을 실행하여 이 작업을 수행할 수 있습니다.

   $ 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

   페더레이션 ID 자격 증명을 사용하면 OpenShift Container Platform 서비스 계정에서 시크릿을 저장하거나 Azure 서비스 주체 ID를 사용하지 않고도 Azure 관리 ID로 인증할 수 있습니다.

   2

   페더레이션 자격 증명에 대해 선택한 이름입니다.

   3

   클러스터에 대한 OpenID Connect(OIDC) 공급자의 URL입니다.

   4

   다음 형식을 따르는 클러스터의 서비스 계정 주체: system:serviceaccount:<namespace>:tempo-<tempostack_instance_name> .

   5

   페더레이션 ID 자격 증명을 위해 발급된 토큰의 유효성을 검사하는 데 사용될 예상 대상입니다. 일반적으로 이는 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 서비스 계정에 대한 페더레이션 ID 자격 증명을 만듭니다. 다음 명령을 실행하여 이 작업을 수행할 수 있습니다.

   $ 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

   페더레이션 ID 자격 증명을 사용하면 OpenShift Container Platform 서비스 계정에서 시크릿을 저장하거나 Azure 서비스 주체 ID를 사용하지 않고도 Azure 관리 ID로 인증할 수 있습니다.

   2

   프런트엔드 페더레이션 ID 자격 증명에 대해 선택한 이름입니다.

   3

   다음 형식을 따르는 클러스터의 서비스 계정 주체: system:serviceaccount:<namespace>:tempo-<tempostack_instance_name> .

4. 생성된 Azure 관리 ID의 Azure 서비스 주체 ID에 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 관리 ID의 Azure 서비스 주체 ID입니다.

   작은 정보

   다음 명령을 실행하면 <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의 클라이언트 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 워크로드 ID 페더레이션(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의 클라이언트 ID입니다.

   4

   선택 사항: 기본값은 api://AzureADTokenExchange 입니다.

   5

   Azure Tenant 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

   credential-source-file 매개변수는 항상 /var/run/secrets/storage/serviceaccount/token 경로를 가리켜야 합니다. Operator가 이 경로에서 토큰을 마운트하기 때문입니다.

   2

   출력 파일을 저장하는 경로입니다.

7. 다음 명령을 실행하여 올바른 대상 고객을 확보하세요.

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

   Copy to Clipboard Toggle word wrap

8. 다음 명령을 실행하여 분산 추적 플랫폼에 대한 저장소 시크릿을 만듭니다.

   $ 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

   이전 단계에서 얻은 audience 값입니다.

   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. TempoStack 사용자 정의 리소스(CR)에 원하는 값과 함께 tenantName 및 tenantId 매개변수를 추가하여 테넌트를 정의합니다.

   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. 추적을 작성하기 위한 쓰기( 생성 ) 권한이 있는 클러스터 역할에 테넌트를 추가합니다.

   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

     서비스 계정 토큰을 사용하기 위한 Bearer Token 확장입니다.

     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의 수출자 섹션에 지정한 수출자입니다.

프로세스

1. 홈 → 프로젝트 → 프로젝트 만들기 로 이동하여 이후 단계에서 만들 TempoStack 인스턴스에 대해 허용된 프로젝트를 만듭니다. openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

2. TempoStack 인스턴스에 대해 생성한 프로젝트의 개체 스토리지 버킷에 대한 비밀을 생성하려면 워크로드 → 비밀 → 생성 → 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. TempoStack 인스턴스를 생성합니다.

   참고

   동일한 클러스터의 별도 프로젝트에서 여러 개의 TempoStack 인스턴스를 만들 수 있습니다.

   1. Operator → 설치된 Operator 로 이동합니다.
   2. TempoStack → TempoStack → YAML 보기를 선택합니다.

   3. YAML 보기에서 TempoStack 사용자 정의 리소스(CR)를 사용자 지정합니다.

      AWS S3 및 MinIO 스토리지와 두 개의 테넌트에 대한 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 및 OTLP(OpenTelemetry Protocol)를 통해 Jaeger Thrift를 수신하도록 구성된 TempoStack 배포를 생성합니다.

      2

      TempoStack 배포를 위해 선택한 프로젝트입니다. openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

      3

      Red Hat은 Red Hat OpenShift Distributed Tracing Platform 문서에서 제공되는 사용자 정의 리소스 옵션만 지원합니다.

      4

      추적을 저장하기 위한 저장소를 지정합니다.

      5

      2단계에서 필수 구성 요소 중 하나로 설정된 개체 저장소에 대해 만든 비밀입니다.

      6

      비밀의 메타데이터 섹션에 있는 이름 필드의 값입니다. 예를 들어: 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 배포의 라이프사이클 전체에 걸쳐 고유해야 합니다. 분산 추적 플랫폼은 이 ID를 사용하여 개체 저장소의 개체에 접두사를 붙입니다. UUID 또는 tempoName 필드의 값을 재사용할 수 있습니다.

      14

      인증 및 권한 부여를 수행하는 게이트웨이를 활성화합니다.

      15

      http://<gateway_ingress>/api/traces/v1/<tenant_name>/search 의 경로를 통해 데이터를 시각화하는 Jaeger UI를 공개합니다.

   4. 생성을 선택합니다.

검증

1. 프로젝트: 드롭다운 목록을 사용하여 TempoStack 인스턴스의 프로젝트를 선택합니다.
2. 운영자 → 설치된 운영자 로 이동하여 TempoStack 인스턴스의 상태가 조건: 준비 인지 확인합니다.
3. 워크로드 → Pod 로 이동하여 TempoStack 인스턴스의 모든 구성 요소 Pod가 실행 중인지 확인합니다.

4. Tempo 콘솔에 액세스합니다.

   1. 네트워킹 → 경로 및 Ctrl+F 로 이동하여 tempo 를 검색합니다.

   2. 위치 열에서 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 인스턴스를 만들 수 있습니다.

   1. TempoStack CR(사용자 정의 리소스)을 사용자 정의합니다.

      AWS S3 및 MinIO 스토리지와 두 개의 테넌트에 대한 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 및 OTLP(OpenTelemetry Protocol)를 통해 Jaeger Thrift를 수신하도록 구성된 TempoStack 배포를 생성합니다.

      2

      TempoStack 배포를 위해 선택한 프로젝트입니다. openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

      3

      Red Hat은 Red Hat OpenShift Distributed Tracing Platform 문서에서 제공되는 사용자 정의 리소스 옵션만 지원합니다.

      4

      추적을 저장하기 위한 저장소를 지정합니다.

      5

      2단계에서 필수 구성 요소 중 하나로 설정된 개체 저장소에 대해 만든 비밀입니다.

      6

      비밀의 메타데이터 섹션에 있는 이름 필드의 값입니다. 예를 들어: 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 배포의 라이프사이클 전체에 걸쳐 고유해야 합니다. 분산 추적 플랫폼은 이 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 구성 요소 의 상태가 실행 중이고 조건이 유형: 준비 인지 확인하세요.

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

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 모든 TempoStack 구성 요소 포드가 실행 중인지 확인하세요.

   $ oc get pods

   Copy to Clipboard Toggle word wrap

3. Tempo 콘솔에 액세스합니다.

   1. 다음 명령을 실행하여 경로 세부 정보를 쿼리합니다.

      $ oc get route

      Copy to Clipboard Toggle word wrap

   2. 웹 브라우저에서 https://<route_from_previous_step>을 엽니다.

      참고

      Tempo 콘솔은 처음에 Tempo 콘솔 설치 후 추적 데이터를 표시하지 않습니다.

프로세스

1. 홈 → 프로젝트 → 프로젝트 만들기 로 이동하여 이후 단계에서 만들 TempoMonolithic 인스턴스에 대해 허용된 프로젝트를 만듭니다. openshift- 접두사로 시작하는 프로젝트 이름은 허용되지 않습니다.

2. 추적을 저장하는 데 사용할 지원되는 스토리지 유형을 결정합니다. 메모리 내 스토리지, 영구 볼륨 또는 개체 스토리지입니다.

   중요

   개체 스토리지는 분산 추적 플랫폼에 포함되지 않으며 지원되는 공급자 (Red Hat OpenShift Data Foundation , MinIO , Amazon S3 , Azure Blob Storage 또는 Google Cloud Storage) 를 통해 개체 저장소를 설정해야 합니다.

   또한, 개체 스토리지를 선택하려면 TempoMonolithic 인스턴스에 대해 생성한 프로젝트에서 개체 스토리지 버킷에 대한 비밀을 생성해야 합니다. 워크로드 → 비밀 → 생성 → 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. Operator → 설치된 Operator 로 이동합니다.
   2. TempoMonolithic → TempoMonolithic 만들기 → YAML 보기를 선택합니다.

   3. YAML 보기 에서 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 인메모리 저장소의 메모리 입니다. 이는 포드가 종료되면 데이터가 유지되지 않으므로 개발, 테스트, 데모 및 개념 증명 환경에만 적합합니다.

      6

      메모리 크기: 메모리 내 저장소의 경우 이는 tmpfs 볼륨의 크기를 의미하며 기본값은 2Gi 입니다. 영구 볼륨의 경우 이는 영구 볼륨 클레임의 크기를 의미하며 기본값은 10Gi 입니다. 개체 스토리지의 경우 이는 Tempo Write-Ahead Logging(WAL)에 대한 영구 볼륨 클레임 크기를 의미하며 기본값은 10Gi 입니다.

      7

      선택 사항: 개체 스토리지의 경우 개체 스토리지 유형입니다. 사용된 객체 저장소 유형에 따라 허용되는 값은 s3 , gcs 및 azure 입니다.

      8

      선택 사항: 개체 저장소의 경우 저장소 비밀의 메타데이터 에 있는 이름 값입니다. 저장소 비밀은 TempoMonolithic 인스턴스와 동일한 네임스페이스에 있어야 하며 "표 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. 생성을 선택합니다.

검증

1. 프로젝트: 드롭다운 목록을 사용하여 TempoMonolithic 인스턴스의 프로젝트를 선택합니다.
2. 운영자 → 설치된 운영자 로 이동하여 TempoMonolithic 인스턴스의 상태가 조건: 준비 인지 확인합니다.
3. 워크로드 → Pod 로 이동하여 TempoMonolithic 인스턴스의 Pod가 실행 중인지 확인합니다.

4. Jaeger UI에 접속하세요:

   1. 네트워킹 → 경로 로 가서 Ctrl+F를 눌러 jaegerui를 검색합니다.

      참고

      Jaeger UI는 tempo-<metadata_name_of_TempoMonolithic_CR>-jaegerui 경로를 사용합니다.

   2. 위치 열에서 URL을 열어 Jaeger UI에 액세스합니다.

5. TempoMonolithic 인스턴스의 포드가 준비되면 클러스터 내부의 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. 추적을 저장하는 데 사용할 지원되는 스토리지 유형을 결정합니다. 메모리 내 스토리지, 영구 볼륨 또는 개체 스토리지입니다.

   중요

   개체 스토리지는 분산 추적 플랫폼에 포함되지 않으며 지원되는 공급자 (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 인스턴스를 만들 수 있습니다.

   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 인메모리 저장소의 메모리 입니다. 이는 포드가 종료되면 데이터가 유지되지 않으므로 개발, 테스트, 데모 및 개념 증명 환경에만 적합합니다.

      6

      메모리 크기: 메모리 내 저장소의 경우 이는 tmpfs 볼륨의 크기를 의미하며 기본값은 2Gi 입니다. 영구 볼륨의 경우 이는 영구 볼륨 클레임의 크기를 의미하며 기본값은 10Gi 입니다. 개체 스토리지의 경우 이는 Tempo Write-Ahead Logging(WAL)에 대한 영구 볼륨 클레임 크기를 의미하며 기본값은 10Gi 입니다.

      7

      선택 사항: 개체 스토리지의 경우 개체 스토리지 유형입니다. 사용된 객체 저장소 유형에 따라 허용되는 값은 s3 , gcs 및 azure 입니다.

      8

      선택 사항: 개체 저장소의 경우 저장소 비밀의 메타데이터 에 있는 이름 값입니다. 저장소 비밀은 TempoMonolithic 인스턴스와 동일한 네임스페이스에 있어야 하며 "표 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 구성 요소 의 상태가 실행 중이고 조건이 유형: 준비 인지 확인하세요.

   $ 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. 웹 브라우저에서 https://<route_from_previous_step>을 엽니다.

4. TempoMonolithic 인스턴스의 포드가 준비되면 클러스터 내부의 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