ホーム
製品
OpenShift Container Platform
4.18
分散トレーシング
3.4. TempoStack インスタンスのインストール

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

手順

Home Projects Create Project に移動して、後続のステップで作成する TempoStack インスタンス用に、許可される任意のプロジェクトを作成します。openshift- 接頭辞で始まるプロジェクト名は許可されません。
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
```
```
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
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 を選択します。

検証

Project: ドロップダウンリストを使用して、TempoStack インスタンスのプロジェクトを選択します。
Operators Installed Operators に移動して、TempoStack インスタンスの Status が Condition: Ready であることを確認します。
Workloads Pods に移動して、TempoStack インスタンスのすべてのコンポーネント Pod が稼働していることを確認します。
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 つ以上のテナントを定義し、読み取りおよび書き込み権限を設定した。詳細は、「テナントの読み取り権限の設定」および「テナントの書き込み権限の設定」を参照してください。

手順

次のコマンドを実行して、後続のステップで作成する TempoStack インスタンス用に、許可される任意のプロジェクトを作成します。
```
oc apply -f - << EOF
apiVersion: project.openshift.io/v1
kind: Project
metadata:
  name: <permitted_project_of_tempostack_instance>
EOF
```
```
$ 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- 接頭辞で始まるプロジェクト名は許可されません。

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

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

$ 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

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

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

検証

次のコマンドを実行して、すべての TempoStack components の status が Running、conditions が type: Ready になっていることを確認します。
```
oc get tempostacks.tempo.grafana.com simplest -o yaml
```
```
$ oc get tempostacks.tempo.grafana.com simplest -o yaml
```
Copy to Clipboard Toggle word wrap
次のコマンドを実行して、すべての TempoStack コンポーネント Pod が稼働していることを確認します。
```
oc get pods
```
```
$ oc get pods
```
Copy to Clipboard Toggle word wrap
Tempo コンソールにアクセスします。
1. 以下のコマンドを実行してルートの詳細をクエリーします。
  $ oc get route
  Copy to Clipboard Toggle word wrap
2. Web ブラウザーで https://<route_from_previous_step> を開きます。
  注記
  Tempo コンソールをインストールした直後は、Tempo コンソールにトレースデータは表示されません。

トップに戻る

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

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

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

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

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

3.4.1. Web コンソールを使用した TempoStack インスタンスのインストールリンクのコピーリンクがクリップボードにコピーされました!

3.4.2. CLI を使用した TempoStack インスタンスのインストールリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

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

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