Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

3.5. TempoMonolithic 인스턴스 설치

중요

TempoMonolithic 인스턴스는 기술 미리 보기 기능에 불과합니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

웹 콘솔이나 명령줄을 사용하여 TempoMonolithic 인스턴스를 설치할 수 있습니다.

TempoMonolithic 사용자 정의 리소스(CR)는 모놀리식 모드에서 Tempo 배포를 생성합니다. 압축기, 배포기, 수집기, 쿼리기, 쿼리 프런트엔드 등 Tempo 배포의 모든 구성 요소는 단일 컨테이너에 포함되어 있습니다.

TempoMonolithic 인스턴스는 메모리 내 스토리지, 영구 볼륨 또는 개체 스토리지에 추적을 저장하는 것을 지원합니다.

소규모 배포, 데모, 테스트 및 Red Hat OpenShift Distributed Tracing Platform(Jaeger) 올인원 배포의 마이그레이션 경로로 모놀리식 모드의 템포 배포가 선호됩니다.

참고

Tempo의 모놀리식 배포는 수평적으로 확장되지 않습니다. 수평적 확장이 필요한 경우 마이크로서비스 모드에서 Tempo 배포를 위해 TempoStack CR을 사용하세요.

3.5.1. 웹 콘솔을 사용하여 TempoMonolithic 인스턴스 설치
링크 복사

중요

TempoMonolithic 인스턴스는 기술 미리 보기 기능에 불과합니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

웹 콘솔의 관리자 보기에서 TempoMonolithic 인스턴스를 설치할 수 있습니다.

사전 요구 사항

  • cluster-admin 역할을 사용하여 클러스터 관리자로 OpenShift Container Platform 웹 콘솔에 로그인되어 있습니다.
  • Red Hat OpenShift Dedicated의 경우 dedicated-admin 역할이 있는 계정을 사용하여 로그인해야 합니다.
  • 하나 이상의 테넌트를 정의하고 읽기 및 쓰기 권한을 구성했습니다. 자세한 내용은 "테넌트에 대한 읽기 권한 구성" 및 "테넌트에 대한 쓰기 권한 구성"을 참조하세요.

프로세스

  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 엔드포인트에서 사용할 수 있습니다.

3.5.2. CLI를 사용하여 TempoMonolithic 인스턴스 설치
링크 복사

중요

TempoMonolithic 인스턴스는 기술 미리 보기 기능에 불과합니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

명령줄에서 TempoMonolithic 인스턴스를 설치할 수 있습니다.

사전 요구 사항

  • cluster-admin 역할의 클러스터 관리자가 활성 OpenShift CLI(oc) 세션입니다.

    작은 정보
    • OpenShift CLI(oc) 버전이 최신 버전인지 확인하고 OpenShift Container Platform 버전과 일치하는지 확인합니다.

    • oc login 명령을 실행합니다. 

      $ oc login --username=<your_username>
      Copy to Clipboard Toggle word wrap
  • 하나 이상의 테넌트를 정의하고 읽기 및 쓰기 권한을 구성했습니다. 자세한 내용은 "테넌트에 대한 읽기 권한 구성" 및 "테넌트에 대한 쓰기 권한 구성"을 참조하세요.

프로세스

  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 엔드포인트에서 사용할 수 있습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat