Instana AutoTrace Webhook
Instana の AutoTrace Webhookは、 Kubernetes および Red Hat OpenShift と互換性のある、変更型Webhookを備えたアドミッションコントローラーです。
詳細については、 「Admission Controllerの変更を通知するWebhook」 を参照してください。
このWebhookは、 Kubernetes または Red Hat OpenShift クラスタ全体で実行されている Node.js、.NET Core、 Ruby、および Python のアプリケーションに対して、 Instana のトレース機能を自動的に設定します。 さらに、 IBM Cloud Pak for Integration で実行されている IBM MQ および App Connect のデプロイメントに対して、 Instana のトレース機能を有効にすることができます。
インストールする前に
制限
- Instana AutoTrace Webhookは、新しい Kubernetes リソースでのみ機能します。 Webhookがインストールされた後、変換を有効にするために新しいリソースを作成する必要があります。 既存のPod( ReplicaSets, )、 StatefulStes,、Deployments( DeploymentConfigs, )を削除し、 Instana ( AutoTrace )のWebhookの設定を完了させるために、それらを再作成してください(例:を使用
kubectl apply)。 - Instana AutoTrace Webhookは、自身がインストールした計測機能を自動的に更新することはありません。 したがって、 Instana AutoTrace の Webhook は、デフォルトでは有効になっていません。
- 1.304.2 以降、 Instana AutoTrace の Webhook は、デフォルトでは Pod と ConfigMaps のみを変更します。 上位レベルのリソース(デプロイメント、デーモンセット、レプリカセット、ステートフルセット、デプロイメントコンフィグなど)は、フラグ
enableHigherLevelResourceMutationが に設定されているtrue場合にのみ変更されます。 詳細については、 「上位レベルのリソースの変更」 を参照してください。 - Instana AutoTrace Webhook をアンインストールしても、変換機能と計測機能は自動的に削除されません。 詳細については、 「計測機能の削除」 を参照してください。
- 「 Instana 」の「 AutoTrace 」Webhookが「 IBM Cloud 」Paks( Cloud Pak for Business Automation および Cloud Pak for Integration )にインストールされている場合、Zenを計測対象から除外する必要があります。 詳細については、 「 IBM Cloud Paksへのインストール」 を参照してください。
対応するプラットフォーム
linux/amd64linux/s390xlinux/arm64
注:Instana ( AutoTrace )では
linux/s390x 、このWebhookは Node.js、 Ruby、 NGINX、および Python のアプリケーションでのみトレースを有効にします。サポートされるランタイム
前提条件
Kubernetes ベースのクラスターに Instana AutoTrace の Webhook をインストールする前に、以下の前提条件が満たされていることを確認してください:
- Kubernetes 1.16 以降がインストールされている。
- Red Hat OpenShift 4.5 以降がインストールされている。
kubectl1.16 以降がインストールされている。- Helm 3.2 以降がインストールされている。 (一部の自動化機能は、 Helm
lookupの関数に依存しています) - アプリケーションの計測を行うために、ターゲットポッドに十分なメモリ制限が設定されていること。 AutoTrace のWebhookは、実行時に計測用ライブラリを読み込むため、余分なメモリ負荷が発生します。 ターゲットのデプロイメントの 属性
spec.template.spec.containers[x].resources.limits.memoryで、計測ファイルをロードするのに十分なメモリを割り当てるようにしてください。 詳細については、 「メモリ不足」 を参照してください。 - AutoTrace Webhook のセキュリティモデルと RBAC の要件を確認してください。 詳細については、 「 AutoTrace Webhook に必要なロールベースのアクセス制御(RBAC)」 を参照してください。
すべての前提条件を確認したら、 Instana の AutoTrace Webhookのインストールに進むことができます。
詳しくは、以下のトピックを参照してください。
- AutoTrace のWebhookのインストール
- AutoTrace のWebhookの設定
- AutoTrace のWebhookと計測機能の更新
- AutoTrace のWebhookをアンインストールする
- AutoTrace Webhook のトラブルシューティング
注:Instana AutoTrace の Webhook は、パッケージ
libinstana_init を使用して技術を監視します。 パッケージのリリースに関する libinstana_init 詳細については、 「パッケージのリリース libinstana_init 」 を参照してください