Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

3.4. TempoStack インスタンスのインストール

TempoStack インスタンスは、Web コンソールまたはコマンドラインを使用してインストールできます。

3.4.1. Web コンソールを使用した TempoStack インスタンスのインストール
リンクのコピー

Web コンソールの Administrator ビューから TempoStack インスタンスをインストールできます。

前提条件

  • cluster-admin ロールを持つクラスター管理者として、OpenShift Container Platform Web コンソールにログインしている。
  • Red Hat OpenShift Dedicated の場合、dedicated-admin ロールを持つアカウントを使用してログインしている。

  • サポートされているプロバイダーによる必要なオブジェクトストレージ Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、Google Cloud Storage の設定が完了している。詳細は、「オブジェクトストレージのセットアップ」を参照してください。

    警告

    オブジェクトストレージは必須ですが、Distributed Tracing Platform には含まれていません。Distributed Tracing Platform をインストールする前に、サポートされているプロバイダーによるオブジェクトストレージを選択して設定する必要があります。

  • 1 つ以上のテナントを定義し、読み取りおよび書き込み権限を設定した。詳細は、「テナントの読み取り権限の設定」および「テナントの書き込み権限の設定」を参照してください。

手順

  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 コンソールにトレースデータは表示されません。

3.4.2. CLI を使用した TempoStack インスタンスのインストール
リンクのコピー

コマンドラインから TempoStack インスタンスをインストールできます。

前提条件

  • cluster-admin ロールを持つクラスター管理者によるアクティブな OpenShift CLI (oc) セッション。

    ヒント
    • OpenShift CLI (oc) のバージョンが最新であり、OpenShift Container Platform バージョンと一致していることを確認してください。

    • oc login コマンドを実行します。 

      $ oc login --username=<your_username>
      Copy to Clipboard Toggle word wrap

  • サポートされているプロバイダーによる必要なオブジェクトストレージ Red Hat OpenShift Data Foundation、MinIO、Amazon S3、Azure Blob Storage、Google Cloud Storage の設定が完了している。詳細は、「オブジェクトストレージのセットアップ」を参照してください。

    警告

    オブジェクトストレージは必須ですが、Distributed Tracing Platform には含まれていません。Distributed Tracing Platform をインストールする前に、サポートされているプロバイダーによるオブジェクトストレージを選択して設定する必要があります。

  • 1 つ以上のテナントを定義し、読み取りおよび書き込み権限を設定した。詳細は、「テナントの読み取り権限の設定」および「テナントの書き込み権限の設定」を参照してください。

手順

  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 コンソールにトレースデータは表示されません。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat