エージェントコンフィギュレーション

トレースデータには機密データが含まれる場合があります。 したがって、Instanaエージェントは、「シークレット」のパターンの仕様、つまり、トレースデータからエージェント側で編集されるデータの仕様をサポートしています。 シークレットとして扱われるデータは、処理のためにInstana SaaSに到達しないため、UIでの分析やAPIを介した取得には使用できません。

Instanaは、一致するシークレットの仕様をサポートしています。

• 環境変数
• JDBC接続文字列
• Dockerコンテナ情報
• HTTPクエリパラメータ（実質的にサポートされるすべてのランタイムについては、以下のサポートマトリックスを参照）、例：https://my.domain/accounts/status?account=&user=
• HTTPマトリックスパスパラメーター。たとえば、https://my.domain/accounts/account=;user=/status （一部のランタイムでサポートを利用できます。以下のサポートマトリックスを参照してください）

注：GoインスツルメンテーションはOpenTracing APIに基づいているため、シークレットの処理はインストルメント側が行います。

注：Instanaは、URLがhttps://my.domain/accounts//status として構成されている場合など、URLパス内の任意のセグメントをシークレットとして扱うことをサポートしていません。 たとえば、URLパスで正規表現を実行してセグメントを破棄するオーバーヘッドは、非常に高くなります。

（さらに、実際にはシークレットに関連する問題ではありませんが、InstanaエージェントはストアドプロシージャからSQLパラメーターをキャプチャしません。任意のパスセグメントの場合と同様に、SQLクエリからリテラルを削除せず、パラメータ化されたクエリの仕様を強くお勧めします。）

シークレットは、サポートされているすべての言語に対して次の方法で指定されます。

com.instana.secrets:
  # One of: 'equals-ignore-case', 'equals', 'contains-ignore-case', 'contains', 'regex'
  matcher: 'contains-ignore-case'
  list:
    - 'key'
    - 'password'
    - 'secret'

センサーによって収集されたキーがリストのエントリと一致する場合、値は編集され、Instanaバックエンドに送信されません。 カスタムシークレット構成を指定しない場合、エージェントはデフォルトで前述のシークレット構成を使用します。

注：一般に、シークレットは静的データからフィルタリングされます。 フィルタリングは最適化されており、プロセスの実行中は変更が適用されません。 シークレット構成を有効にするには、エージェントまたは実行中の監視対象コンポーネントを再起動します。これらは新しい構成を尊重する必要があります。

注：選択したKubernetesリソースでの追加のシークレットリダクションについては、Kubernetesシークレットで詳細をご覧ください。