Instana AutoTrace Webhook
Instana AutoTrace webhook は、 Kubernetes および Red Hat OpenShift と互換性のあるアドミッションコントローラー変異 webhook です。
詳細については、 アドミッションコントローラのミューティングウェブフックを参照してください。
この Webhook は、 Node.js、.NET Core、Ruby、 Python アプリケーションで、 Kubernetes または Red Hat OpenShift クラスタ全体で実行される Instana トレースを自動的に構成します。 さらに、 IBM Cloud Pak for Integration で実行される IBM MQ および App Connect デプロイメントに対して Instana トレースを有効にできます。
インストールする前に
Instana AutoTrace ウェブフックをインストールする前に、 制限事項、 サポートされるランタイム、 前提条件を確認してください。
制限
- Instana AutoTrace ウェブフックは、新しい Kubernetes リソースでのみ機能します。 Webhookがインストールされた後、変換を有効にするために新しいリソースを作成する必要があります。 既存の Pod、 ReplicaSets, StatefulStes, Deployments、 DeploymentConfigs, を削除してから、Instana AutoTrace Webhook の設定を完了するために再作成します (たとえば、
kubectl applyを使用します)。 - Instana AutoTrace webhook は、インストールしたインストルメンテーションを自動的に更新しません。 そのため、Instana AutoTrace ウェブフックはデフォルトでは有効になっていません。
- 1.304.2 以降、Instana AutoTrace ウェブフックはデフォルトでポッドと 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
注:
linux/s390x および linux/arm64 では、Instana AutoTrace ウェブフックにより、 Node.js、Ruby、 Python アプリケーションのみのトレースが可能です。サポートされるランタイム
前提条件
Kubernetes ベースのクラスタに Instana AutoTrace Webhook をインストールする前に、以下の前提条件が満たされていることを確認してください:
- Kubernetes 1.16 またはそれ以降がインストールされていること。
- Red Hat OpenShift 4.5 またはそれ以降がインストールされていること。
kubectl1.16 またはそれ以降がインストールされていること。- Helm 3.2 またはそれ以降がインストールされていること。 (自動化の中には、 Helm
lookup関数に依存するものもある) - アプリケーションのインスツルメンテーションに必要な、ターゲットポッド内の十分なメモリ制限。 AutoTrace ウェブフックは、実行時にインスツルメンテーション・ライブラリをロードするため、余分なメモリ・オーバーヘッドが発生する。 ターゲット配置の
spec.template.spec.containers[x].resources.limits.memory属性に、インスツルメンテーション ファイルをロードするのに十分なメモリが割り当てられていることを確認してください。 詳しくは、 メモリ不足を参照のこと。
すべての前提条件を確認したら、Instana AutoTrace ウェブフックのインストールに進みます。
詳しくは、以下のトピックを参照してください。
- AutoTrace ウェブフックのインストール
- AutoTrace ウェブフックの設定
- AutoTrace ウェブフックとインストルメンテーションの更新
- AutoTrace ウェブフックのアンインストール
- AutoTrace ウェブフックのトラブルシューティング
注: Instana AutoTrace ウェブフックは、
libinstana_init パッケージを使用してテクノロジーを監視します。 libinstana_init パッケージ・リリースの詳細については、 libinstana_init パッケージ・リリースを参照のこと