Instana 選択的監視

Instana Agent のデフォルト設定では、インストールされているホスト上のすべてのプロセスを検出・監視します。 これは、環境 INSTANA_SELECTIVE_MONITORING 変数が設定されていないか、明示的に に設定されている場合の OPT_OUTデフォルトの動作です。 特定のプロセスを検出時に無視し、監視時にも無視する必要がある場合は、環境 INSTANA_MONITORING 変数を に設定することで false、そのプロセスの監視を無効にすることができます。 Instana エージェントは、プロセス環境に INSTANA_MONITORING=false が含まれるすべてのプロセスを無視します。

Instana エージェントのデフォルトの検出動作を変更するには、環境変数を INSTANA_SELECTIVE_MONITORING に設定してエージェントを起動 OPT_INする必要があります。 このモードでは、エージェントは、監視を明示的に許可したプロセスのみを検出します。 モード OPT_IN で監視が必要な各プロセスでは、環境変数を INSTANA_MONITORING に設定する必要があります true。 Instana エージェントは、プロセス環境に INSTANA_MONITORING=true が含まれるプロセスのみを監視します。

モニター・モード	説明	エージェント環境	プロセス環境	結果
オプトアウト	すべてのプロセスはデフォルトで監視されます	未設定、または INSTANA_SELECTIVE_MONITORING=OPT_OUT	設定なし	そのプロセスは監視されています
オプトアウト	すべてのプロセスはデフォルトで監視されます	未設定、または INSTANA_SELECTIVE_MONITORING=OPT_OUT	INSTANA_MONITORING=false	この処理は無視されます
オプトイン	デフォルトでは監視対象のプロセスはありません	INSTANA_SELECTIVE_MONITORING=OPT_IN	設定なし	この処理は無視されます
オプトイン	デフォルトでは監視対象のプロセスはありません	INSTANA_SELECTIVE_MONITORING=OPT_IN	INSTANA_MONITORING=true	そのプロセスは監視されています

Kubernetes ベースのワークロードについては、コンテナレベルまたはネームスペースレベルでオプトインおよびオプトアウトモードを設定してください。 以下の例は、「example-workload」の監視を無効にするための Kubernetes のデプロイ設定を示しています。 「 出力プロセスの監視 」で説明されている環境変数は、ワークロードのコンテナ上で環境変数として設定されます：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: example-workload
spec:
  ...
  template:
    spec:
      containers:
      - name: example-workload
        image: example-workload-image
        env:
        - name: INSTANA_MONITORING
          value: false

オプトインモードでは、エージェントに対して適切な環境変数を設定する必要があります。 Operator を使用してエージェントをデプロイする場合、次の例に示すように、エージェントの ` CustomResource ` を設定できます

apiVersion: instana.io/v1
kind: InstanaAgent
metadata:
  name: instana-agent
  namespace: instana-agent
spec:
  cluster:
      name: example-cluster
  agent:
    key: <agent-key>
    endpointHost: ingress-red-saas.instana.io
    endpointPort: "443"
    env:
      INSTANA_SELECTIVE_MONITORING: "OPT_IN"

Helm のチャートベースのデプロイを行う場合は、環境変数を設定 values.yaml するか、 Helm を実行する際に Helm コマンドオプションを指定して適用してください：

--set agent.env.INSTANA_SELECTIVE_MONITORING='OPT_IN'

# create a new namespace
$ kubectl create ns demo
namespace/demo created
# monitor workloads in the demo namespace
$ kubectl label ns demo instana-workload-monitoring=true
namespace/demo labeled
# remove label
$ kubectl label ns demo instana-workload-monitoring-
namespace/demo unlabeled