既知の問題および制限

IBM Instana 可観測性の既知の問題と制限を確認します。

既知の問題

Windows Server 2016 上の Instana エージェントでのメモリーの問題

Windows Server 2016 ホストでは、Instana エージェントによって使用されるライブラリーは、メモリーを正しく解放せずに徐々にメモリーを消費するため、影響を受ける Windows システムでメモリー使用量が増加する可能性があります。 メモリー使用量を制御下に維持するために、Instana エージェントは自動的に再始動されます。 自動再始動機能は、メモリーの問題がエージェントの自動更新に影響しないようにするためのものです。 Windows Server 2016 にデプロイされたすべての Instana エージェントは、デフォルトでは 05:00 から 05:30 AM の間に 7 日ごとに再始動します。 この機能は、Instana エージェント・バンドル 1.1.702以降で使用可能です。 エージェント・バンドルのバージョンは、Instana エージェントの始動ログで確認できます。

デフォルトの再始動動作を変更するには、Instana エージェントを開始する前に、以下の環境変数を設定します。

環境変数名 デフォルト 注
INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_ENABLED true 自動再始動を有効または無効にするフラグ。
INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_RESTART_TIME 5:15 Instana エージェントが再始動する時刻。
INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_JITTER_IN_MIN 30 エージェントが再始動する時刻範囲を設定するためのジッター (分単位)。 ジッターは、Instana エージェントが同時に再始動しないようにするためのものです。 再始動時間は、指定された範囲内でランダムに選択されます。 再始動時間のランダム化を変更するには、1 より大きい値を設定します。 再始動時間の時刻範囲は、式 INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_RESTART_TIME -(INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_JITTER_IN_MIN/2) および INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_RESTART_TIME + (INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_JITTER_IN_MIN/2) を使用して計算されます。 例えば、再始動時間が 30 分のジッターで 5.15 AM に設定されている場合、再始動は 05:00 から 05:30 AM の間に行われます。
INSTANA_AUTO_RESTART_WINDOWS_SERVER_2016_RESTART_MIN_INTERVAL_IN_DAYS 7 次の再始動が行われるまでの間隔。 ゼロより大きい値を設定してください。

既知の制限

トレースおよび呼び出しの分析

呼び出しが log.level または log.messageによってグループ化されている場合、特殊タグ・グループ Tag not present は、他のタグと同じようには表示されません。

この機能について詳しくは、「 トレースおよび呼び出しの分析」を参照してください。

動的フォーカスによるフィルタリング

この機能について詳しくは、「 動的フォーカスによるフィルタリング 」を参照してください。

構文制約

  • ! と否定する照会の間に空白を入れることはできません。 代わりに !<query> または NOT <query> を使用してください。
  • ダイナミック・フォーカス・キーワードの entity.application.name、entity.service.name、entity.endpoint.name のうち、同じキーワードを同時に複数回使用する場合は、OR 演算子を使用して結合する必要があります。 E.g. 照会 entity.application.name:foo AND entity.application.name:bar, entity.application.name:foo entity.application.name:bar はサポートされていません。 照会 entity.application.name:foo OR entity.application.name:bar はサポートされます。
  • ダイナミック・フォーカスキーワードの entity.application.name、entity.service.name、entity.endpoint.name のうち、異なるキーワードを同時に使用する場合は、AND 演算子を使用して結合する必要があります。 E.g. 照会 entity.application.name:foo AND entity.service.name:bar はサポートされていますが、照会 entity.application.name:foo OR entity.service.name:bar はサポートされていません。
  • アプリケーション名、サービス名、またはエンドポイント名の否定を含む照会はサポートされません。 そのため、NOT entity.application.name:foo、!entity.service.name:bar、および NOT entity.endpoint.name:foobar はいずれも無効です。 ただし、代わりに NOT event.entity.label:foo を使用することで、アプリケーション、サービス、またはエンドポイントのイベントを除外することはできます。
  • ダイナミック・フォーカス・クエリー entity.application.name:<term>、 entity.service.name:<term> および entity.endpoint.name:<term> は、ストリング contains ロジックを使用して評価されます。例えば、ダイナミック・フォーカス・クエリー entity.application.name:shop も entity.application.name:shop-frontendと一致します。
  • ダイナミック・フォーカス照会キーワード entity.application.name、entity.service.name、および entity.endpoint.name は、ブール照会 (上記のブール論理の制約を参照)、用語照会、語句照会、および接頭語照会でのみサポートされます。

照会の制限

  • ハイフンが含まれる event.text に対するダイナミック・フォーカス・クエリーからは、予期しない結果が返される可能性があります。 例: また、 event.text:"foo-bar-random" は、Lucene アナライザーのトークン化のために、 foo または bar または random のみを含むイベントを返します。
  • Docker コンテナーに続くエンティティー ( 「ホスト」 や 「アベイラビリティー・ゾーン」など) は、ほとんどの Kubernetes キーワードにスコープを設定するときに選択できません。 例えば、クエリー entity.kubernetes.deployment.name:my-K8s-deployment AND entity.selfType:host はホストを返しません。 一方、クエリー entity.kubernetes.deployment.name:my-K8s-deployment AND entity.selfType:docker は、デプロイメントに関連するすべての Docker コンテナーを返します。 ただし、 ホスト entites, nameley entity.kubernetes.cluster.* および entity.kubernetes.node.*を選択するために使用できる Kubernetes キーワードがいくつかあります。 例えば、照会 entity.kubernetes.cluster.label:my-K8s-cluster AND entity.selfType:host は、クラスターのすべての関連ホストを返します。

インフラストラクチャー・メトリック

  • パフォーマンス上の理由から、エンティティーは、最大 3000 個のメトリックを Instana UI に表示するように制限されています。 この制限を超える数のメトリックを持つダッシュボードには、欠落しているメトリックがあります。
  • 負のメトリック値は表示されません。

モニター IBM App Connect Enterprise (ACE)

  • REST API インターフェースで HTTPS が有効になっている場合は、 <agent_install_dir>/etc/instana/configuration.yamlでキーストアと keystorePassword のパラメーターを指定する必要があります。 鍵ストア・タイプには、JKS または P12 のみがサポートされます。

この機能について詳しくは、 Monitoring IBM App Connect Enterprise (ACE) を参照してください。

Monitoring IBM API Connect アプリケーション

  • DataPower トレースは API ゲートウェイのみをサポートし、マルチプロトコル・ゲートウェイや Web サービス・プロキシーなどの他のサービスはサポートしません。

この機能について詳しくは、 Monitoring IBM API Connect アプリケーション を参照してください。

Jaeger トレース

  • Jaeger から収集されたトレース・データは、AutoTrace を介して収集されたトレース・データと相関されません。その結果、Jaeger と Instana AutoTrace によってそれぞれトレースされたシステムが、相互に直接対話する場合であっても、別々のトレースになります。

  • Jaeger トレース・データは、どのプロセスがそれらをホスト・エージェントに送信するかという概念を伝達しないため、Instana は、それらのトレースをホスト・エージェントを支えるホストに相関させます。 これにより、プロセスとの関連付けが回避されます。したがって、コンテナーとプラットフォームの階層 (Kubernetes ポッド、名前空間、クラスターなど) との関連付けも防止されます。

  • Jaeger には、ユーザー・モニターの概念がありません (ただし、 W3C TraceContext.md の採用によって最終的には変更される可能性があります)。そのため、Instana Web サイト・モニター で収集されたビーコンは、Jaeger から収集されたバックエンド・トレースと相関しません。

  • ホスト・エージェントは、HTTP のみを介した Jaeger トレースの収集をサポートします。 JAEGER_AGENT_HOST および JAEGER_AGENT_PORT 環境変数を構成する場合に使用されるプロトコルである UDP は、サポートされません。

この機能について詳しくは、 Jaeger を参照してください。

OpenTelemetry トレース

  • OpenTelemetry links はサポートされていません。
  • Instana のデフォルト・コンテキスト・プロパゲーターと W3C Trace Context 以外のコンテキスト・プロパゲーターを混在させることはサポートされていません。 W3C Trace Context は、 OpenTelemetryのデフォルトのコンテキスト・プロパゲーターです。

この機能について詳しくは、 OpenTelemetry トレース を参照してください。

Zipkin トレース

  • Zipkin から収集されたトレース・データは、AutoTrace を介して収集されたトレース・データと相関されません。その結果、Zipkin と Instana AutoTrace によってそれぞれトレースされたシステムが、相互に直接対話する場合であっても、別々のトレースになります。

  • Zipkin にはユーザー・モニターの概念がありません (ただし、これは最終的に W3C TraceContext.md の採用によって変更される可能性があります)。そのため、Instana Web サイト・モニター で収集されたビーコンは、 Zipkinから収集されたバックエンド・トレースと相関しません。

  • ホスト・エージェントは、HTTP を介した Zipkin トレースの収集のみをサポートします。これは、Zipkin の COLLECTOR_HTTP_ENABLED設定に対応します。

この機能について詳しくは、 Zipkin を参照してください。

モニター Containerd

CPU Total Normalized および Memory Working Set Usage % メトリックは、制御グループ v1 (cgroupv1) を使用しているシステムでのみ使用可能です。

Amazon MSK のモニター

Amazon MSK センサーは、プロビジョンされた MSK クラスター・タイプのモニターのみをサポートします。 サーバーレス・クラスター・タイプはサポートされていません。

ALPN サポート

Instana エージェントおよびバックエンドは、以下の要件が満たされている場合に、Application-Layer Protocol Negotiation (ALPN) 接続をサポートします。

  • Netty 4.1.49.Final 以降
  • Java Development Kit (JDK) 1.8.0_251 以降

高い CPU 使用量のアドレッシング

エージェント・コンテナー 1.263.3 以前のホット・スポット・ベースのエージェントでは、CPU 使用率が高くなります。 この問題を解決するには、エージェントを再インストールしてください。 予約済みコード・キャッシュ・サイズが、高い CPU 使用量をサポートするように増やされました。 ホスト環境で実行されるエージェントの場合は、エージェントを削除してから再インストールします。

Kubernetes (k8s) または OpenShift Container Platform (OCP) を使用している場合は、以下の手順を実行します。

  1. エージェントのアンインストール:

    helm uninstall instana-agent

  2. エージェントのインストール:

    Instana エージェントをインストールするには、 Kubernetes または OpenShift Container Platformで Helm チャートを使用します。

シンセティック・テスト属性

scriptType としての Jest は、UI および API でのブラウザー・シンプル・テスト、API スクリプト・テスト、および API シンプル・テストではサポートされていません。 scriptType としての Jest は、ブラウザー・スクリプト・テストでのみ使用できます。

一部のシンセティック・テスト属性は、Instana UI ではサポートされていません。 これらの属性を設定するには、Open API または synctl ツールを使用します。 Instana UI でサポートされない属性を以下の表にリストします。

テスト属性 ブラウザー・スクリプト ブラウザー (シンプル) API シンプル API スクリプト
ブラウザー ☒ ☒ 該当なし 該当なし
recordVideo ☒ ☒ 該当なし 該当なし
expectExists 該当なし 該当なし ☒ 該当なし
expectNot空 該当なし 該当なし ☒ 該当なし
markSynthetic呼び出し ☒ ☒ ☒ ☒
再試行 ☒ ☒ ☒ ☒
retryInterval ☒ ☒ ☒ ☒
タイムアウト ☒ ☒ ☒ ☒
ScriptType ☒ 該当なし 該当なし ☒
HEAD (操作) 該当なし 該当なし ☒ 該当なし
DELETE (操作) 該当なし 該当なし ☒ 該当なし
OPTIONS (操作) 該当なし 該当なし ☒ 該当なし
PATCH (操作) 該当なし 該当なし ☒ 該当なし
POST (操作) 該当なし 該当なし ☒ 該当なし
PUT (操作) 該当なし 該当なし ☒ 該当なし

記号 ☒ は、その属性が Instana UI でサポートされていないことを示します。

N/A は、属性がテスト・タイプに適用されないことを示します。