セルフホスト型 Classic Edition のトラブルシューティング ( Docker )

一時ディレクトリー (instana-debug_{timestamp}) は、 instana debug コマンドを実行するディレクトリーと同じディレクトリーに作成されます。このディレクトリーには、システム、ハードウェア、インストールされているすべてのコンポーネントの状態とその正常性、およびコンポーネント構成設定に関する情報が含まれ、サポート・エンジニアに役立つ情報が提供されます。 さらに、すべての情報がinstana-debug_{timestamp}.tar.gzファイルに書き込まれます。

Classic Editionでの問題のトラブルシューティング方法に関する情報。

instana デバッグコマンドを実行すると、バックエンドが実行されているシステムのデバッグ情報をダンプできます。 問題が発生した場合は、これが最初のステップです。

デバッグ情報には、システム、ハードウェア、インストールされているすべてのコンポーネントの状態、およびそれらの正常性に関する情報が含まれます。 このデータはローカルで収集され、ワイヤー経由では何も送信されません。

Instana サービスのログレベルの設定

15 分間、特定のサービスのログ・レベルをDEBUGに調整できます。

  1. 以下のコマンドを実行して、Instana Docker コンテナー名を取得します。

    docker ps --format '{{ .Names }}' | cut -d'-' -f 2-5
     
  2. 以下のコマンドを実行して、特定の Instana サービスのログ・レベルをDEBUGに設定します。

    instana configure debug-log {service}
     

    {service} を、デバッグするサービスに関連する Intana Docker コンテナー名に置き換えます。

    例えば、Instana コンテナーinstana-acceptorのログ・レベルをDEBUGに設定するには、以下のコマンドを実行します。

    instana configure debug-log acceptor
     

一部の指標がダッシュボードに表示されない

一部のメトリックがダッシュボードに表示されない場合は、メトリックの制限に達している可能性があります。 デフォルトでは、メトリック制限は 3000 に設定されています。 メトリックの制限を増やすには、以下の例に示すように settings.hcl ファイルを更新します。

toggle "config.max.metrics" {
  value = "6000"
}
 

次に、 instana update コマンドを実行して変更を適用します。

Instana Elasticsearch のデータディスクの使用率が85%を超えると、バックエンドが機能しなくなります

Elasticsearch 使用中のディスクの使用率が85%を超えると、データストアは自動的に読み取り専用モードに切り替わります。 これにより、 Instana バックエンドが動作しなくなります。 Elasticsearch のデータディスクの空き容量を確保するか、容量を増やして、正常な動作を回復させてください。 注:他の Instana ディスクでは、同程度の使用率(95%を超えていても)では読み取り専用モードには移行しないため、この問題の理解を難しくしている可能性があります。

この問題を解決するには、次のいずれかの対処を行ってください:
  • Elasticsearch のデータディスクの空き容量を増やす
  • Elasticsearch に割り当てられているディスク容量を増やす
十分な空き容量が確保されると、 Elasticsearch は通常の書き込み処理を再開し、バックエンドは再び正常に動作するようになります。
注: 他の Instana ディスクは、同程度の使用率(95%を超えていても)では読み取り専用モードには移行しないため、トラブルシューティングの際に混乱を招く可能性があります。