AutoTrace のWebhookのインストール

Instana の AutoTrace Webhookは、オンライン環境でもオフライン（エアギャップ）環境でもインストールできます。詳しくは、以下のセクションを参照してください。

オンライン環境へのインストール
- IBM Cloud Paksへのインストール
エアギャップ環境へのインストール
Webhookのインストール確認

開始する前に、 AutoTrace Webhookの対応ランタイムと前提条件を確認してください。詳細については、「インストール前の注意事項」を参照してください。

オンライン環境へのインストール

オンライン環境に AutoTrace のWebhookをインストールするには、クラスタの管理者権限で次のコマンドを実行してください：

helm install --create-namespace --namespace instana-autotrace-webhook instana-autotrace-webhook \
  --repo https://agents.instana.io/helm instana-autotrace-webhook \
  --set webhook.imagePullCredentials.password=<download_key>

スクリプト内のを、有効な <download_key>Instana エージェントキーまたはダウンロードキーに置き換えてください。

Red Hat OpenShift に AutoTrace の Webhook をインストールする場合は、次の Helm 引数を追加する必要があります：

--set openshift.enabled=true

その他のWebhook設定オプションについては、「 AutoTrace Webhookの設定」を参照してください。

このスクリプトは、クラスターに AutoTrace のWebhookをインストールします。

AutoTrace のWebhookをインストールしたら、インストールが正常に完了し、Webhookが正常に動作することを確認してください。詳細については、「Webhookのインストールを確認する」を参照してください。

IBM Cloud Paksへのインストール

オンラインで編集する

IBM Cloud Pak に AutoTrace のWebhookをインストールするには、 Ruby の計測機能を無効にして、ZenのデプロイメントをWebhookの計測対象から除外する必要があります。

Ruby の計測機能を無効にするには、次の Helm 引数を追加してください：

--set autotrace.ruby.enabled=false

Ruby を使用するアプリケーションを監視するには、名前空間を無視する、監視を有効または無効にする、リソースを無視するなどの他のオプションを検討することができます。

IBM Cloud Paksへの Instana Autotrace Webhookのインストール方法および除外オプションに関する詳細な手順については、「 Cloud Pak 環境での Instana AutoTrace Webhookの設定方法」を参照してください。

エアギャップ環境へのインストール

オンラインで編集する

エアギャップ環境に AutoTrace のWebhookをインストールするには、環境内に Helminstana-autotrace-webhook チャート、コンテナ instana-autotrace-webhook イメージ、およびコンテナ instrumentation イメージを用意する必要があります。

Helm チャートの最新版を現在の作業ディレクトリにダウンロードするには、次のコマンドを実行してください：
```
helm pull instana-autotrace-webhook --repo https://agents.instana.io/helm instana-autotrace-webhook
 
```
このコマンドの保存先ディレクトリを変更するには、オプションを使用してください -d <DESTINATION_PATH>。必要な保存先ディレクトリに <DESTINATION_PATH> 置き換えてください。
最新の instana-autotrace-webhook イメージをダウンロードするには、次のコマンドを実行してください：
```
docker pull containers.instana.io/instana/release/agent/instana-autotrace-webhook:latest
 
```
最新のインストルメンテーション・イメージをダウンロードするには、次のコマンドを実行してください：
```
docker pull icr.io/instana/instrumentation:latest
 
```
Container Registry に、2つのコンテナイメージが確実に存在することを確認してください。
Instana の AutoTrace Webhookをインストールするには、次のコマンドを実行してください：

コマンド helm install を実行するシステム上で、 Helm のチャートアーカイブが利用可能であることを確認してください。
```
helm install --create-namespace \
--namespace instana-autotrace-webhook \
--set webhook.image=<INSTANA_AUTOTRACE_WEBHOOK_IMAGE_PATH> \
--set autotrace.instrumentation.image=<INSTRUMENTATION_IMAGE_PATH> \
instana-autotrace-webhook <PATH_TO_HELM_CHART_ARCHIVE>
 
```

その他のWebhook設定オプションについては、「 AutoTrace Webhookの設定」を参照してください。

このコマンドは、エアギャップ環境のシステムに AutoTrace のWebhookをインストールします。

Container Registry 認証

オンラインで編集する

Container Registryinstrumentation 内のイメージは、すべてのアプリケーションポッドで initContainer として使用されます。 Container Registry で imagePullSecret リソースが必要な場合、そのリソースはすべてのアプリケーションネームスペースで利用可能である必要があります。

Webhookのインストール確認

オンラインで編集する

Webhookが正常に動作していることを確認するには、以下の手順を実行してください：

名前 instana-autotrace-webhook 空間内の instana-autotrace-webhook が正常に動作していることを確認するには、次のコマンドを実行してください：

kubectl get pods -n instana-autotrace-webhook

結果のサンプル:

NAME                                         READY   STATUS    RESTARTS   AGE
instana-autotrace-webhook-7c5d5bf6df-82w7c   1/1     Running   0          12m
instana-autotrace-webhook-7c5d5bf6df-nlq5t   1/1     Running   0          12m

Instana の AutoTrace Webhookを使用してください。 Instana の AutoTrace Webhookが実行中の場合は、 Node.js ポッドをデプロイします。 Instana AutoTrace Node.js ポッドでは自動的に有効になります。ポッドのログには、 Instana AutoTrace が Node.js ポッドに適用されたことを示すラベルが表示されています：
```
kubectl get pod test-nodejs -n test-apps -o=jsonpath='{.metadata.labels.instana-autotrace-applied}'
true
 
```

「 instana/agentHelm 」チャートを使用して Instana ホストエージェントをインストールした場合、 Instana ダッシュボードに「 Node.js 」プロセスが表示されます。詳細については、「 Kubernetes へのホストエージェントのインストール」を参照してください。

ただし、コンテナにラベル instana-autotrace-applied が表示されない場合は、「 AutoTrace Webhook のトラブルシューティング」を参照してください。