Elasticsearch:Kibana に関するよくある質問

Kibana コンソールへのログイン

デフォルトのユーザー名 elastic と、Elasticsearch インスタンスの作成時に指定したパスワードを使用して、Kibana コンソールにログインします。パスワードを忘れた場合は、「インスタンスのアクセスパスワードのリセット」をご参照ください。

elastic アカウントのパスワードの用途

設定の更新 ボタンがグレーアウトする理由

Elasticsearch インスタンスが正常な状態でない場合、Kibana の 設定の更新 ボタンがグレーアウトすることがあります。インスタンスが正常な状態に戻るのを待つか、原因を調査してください。

Kibana コンソールからパブリックサービスへのアクセス可否

いいえ。Kibana コンソールは VPC 内のサービスにのみアクセスでき、Baidu Maps や Amap などのパブリックネットワークサービスにはアクセスできません。パブリック IP アドレスホワイトリストは、Kibana へのインバウンドアクセスを制御するものであり、Kibana からパブリックネットワークへのアウトバウンドアクセスを制御するものではありません。

Kibana コンソールにおける権限管理のベストプラクティス

• 日常的な操作には elastic アカウントを使用せず、専用のユーザーとロールを作成してください。詳細については、「Elasticsearch X-Pack を使用したロールベースのアクセス制御」をご参照ください。

• 検索サービスに elastic アカウントを使用しないでください。elastic のパスワードが漏洩すると、クラスター全体がセキュリティリスクにさらされます。

• elastic のパスワードは慎重に変更してください。サービスが elastic アカウントを使用している場合、パスワードをリセットすると認証に失敗し、サービスが中断します。

「Kibana server is not ready yet」エラー

「Maximum call stack size exceeded」エラー

• 原因

  インスタンスが異常な状態です。ヒープメモリ使用量が高いため、リクエストがタイムアウトします。

• 解決策

  バルクリクエストのサイズを小さくするか、クラスターをアップグレードしてください。

Kibana にアクセスしないデータクリア方法

開発ツールにアクセスできない場合の解決策

Kibana ノードの仕様が 1 vCPU、2 GiB であるか確認してください。この仕様は不安定になる可能性があり、テストにのみ適しています。できるだけ早くクラスターをアップグレードしてください。

シャードとインデックス情報の表示方法

• GET _cat/indices?v コマンドを実行してインデックス情報を表示し、GET _cat/shards?v を実行してシャード情報を表示します。

• [モニタリング] ページでは、ヒープメモリ使用量など、特定のノード上のインデックスのシャーディングステータスを表示できます。

「You do not have permission to manage users」エラー

カスタムプラグインのサポート状況

いいえ。7.0 より前のバージョンの Kibana は、デフォルトのコンソールプラグインのみをサポートしています。Kibana 7.0 以降はどのプラグインもサポートしていません。

言語変更をサポートする Kibana のバージョン

Kibana 6.7.0 以降のみが言語の切り替えをサポートしています。コンソールは英語と中国語をサポートしています。言語 設定を変更して言語を切り替えることができます。詳細については、「Kibana コンソールの言語の設定」をご参照ください。

Kibana のプライベート IP が VPC 外部にある問題

Kibana V7.16 および一部の V7.10 クラスターには、HTTPS 証明書の置換中の再起動を防ぐレイヤー 7 エージェントサービスが含まれています。プライベートエンドポイントは、このエージェントサービスに解決されます。このアーキテクチャは Alibaba Cloud によってセキュリティレビューを受けており、Kibana の機能には影響しません。

CSV エクスポートにおけるデータサイズの設定

デフォルトの CSV エクスポートサイズの制限は 10,485,760 バイト (10 MB) で、xpack.reporting.csv.maxSizeBytes パラメーターによって制御されます。この制限を超えるデータは切り捨てられます。server.maxPayloadBytes パラメーターも、Kibana サーバーリクエストの最大ペイロードサイズを制限します。Alibaba Cloud Elasticsearch は、クラスターの安定性を確保するために、xpack.reporting.csv.maxSizeBytes または server.maxPayloadBytes パラメーターの変更をサポートしておらず、これらはデフォルト値のままです。

デフォルトの制限を超えるデータをエクスポートする必要がある場合は、次の代替案を検討してください。

• Kibana でより具体的なフィルターを適用するか、より短い時間範囲を指定して、より小さなバッチでデータをエクスポートしてください。

• Logstash を使用して大規模なデータセットをエクスポートしてください。Logstash は設定可能なバッチサイズと出力先をサポートしているため、大規模なデータエクスポートシナリオに適しています。

Kibana プラグインのインストール方法

「Kibana プラグインを使用してデータをクエリまたはデータにタグを追加する」をご参照ください。

X-Pack 有効化後の Kibana 500 エラー

Elasticsearch クラスターで X-Pack を有効にすると、Kibana へのアクセス時に 500 エラーが発生することがあります。

• 原因

  X-Pack が有効になると、クラスターは設定をすべてのノードに配布するのに時間が必要です。この間、Kibana は起動できず、500 エラーを返します。設定を有効にするには、Kibana を再起動する必要があります。

• 解決策

  1. クラスターが X-Pack 設定の配布を完了するのを待ってください。このプロセスは通常、数分かかります。

  2. 設定の配布が完了したら、Elasticsearch コンソールから Kibana ノードを再起動してください。クラスター管理ページで Kibana ノードを見つけ、再起動してください。

インデックスパターン作成時のワイルドカード不一致問題

Kibana でインデックスパターンを作成する際、ワイルドカードパターンがどのインデックスにも一致しない場合があります。

• 原因

  ワイルドカードパターンがインデックス名の実際のプレフィックスと一致していません。たとえば、インデックス名が owl_resell_20231001 の場合、プレフィックスが一致しないため、パターン resell_* はインデックスに一致しません。代わりに owl_resell* を使用する必要があります。

• 解決策

  1. インデックスの実際の名前を確認してください。Kibana の開発ツールコンソールで GET _cat/indices?v を実行して、すべてのインデックスを一覧表示します。

  2. ワイルドカードパターンがインデックス名の実際のプレフィックスと一致していることを確認してください。たとえば、owl_resell* を使用して、owl_resell_20231001 および owl_resell_20231002 という名前のインデックスに一致させます。このパターンは完全なプレフィックスと一致しないため、resell_* は使用しないでください。

  3. パターンがインデックスに正常に一致したら、次のステップでインデックスの正しい時間フィールドを選択して、インデックスパターンの作成を完了してください。

Kibana へのアクセス不可問題 (証明書更新後を含む)

Kibana にアクセスできない場合は、次のシナリオに基づいてトラブルシューティングを行ってください。

• プライベートネットワークでの時刻同期の問題

  クラウドデスクトップなどのクライアントデバイスのシステム時刻がサーバー時刻と同期していない場合、プライベートネットワーク経由で Kibana にアクセスできないことがあります。クライアントデバイスのシステム時刻を確認し、サーバー時刻と同期していることを確かめてください。

• 証明書の更新

  Elasticsearch クラスターの HTTPS 証明書を更新した後、新しい証明書設定が有効になるまで Kibana にアクセスできなくなることがあります。Elasticsearch コンソールから Kibana ノードを再起動して、新しい証明書を適用してください。

• 一般的なトラブルシューティング

  問題が解決しない場合は、次の点を確認してください。

  • Elasticsearch インスタンスが正常な状態であることを確認してください。

  • IP アドレスホワイトリストが正しく設定されており、クライアントの IP アドレスが含まれていることを確認してください。

  • ブラウザーのキャッシュをクリアして、もう一度試してください。

Discover と Elasticsearch のタイムスタンプが一致しない理由

Kibana の Discover UI は、デフォルトでブラウザーのローカルタイムゾーンでタイムスタンプを表示する一方、Elasticsearch は内部的にタイムスタンプを UTC (協定世界時) として保存します。この動作により、表示される時刻と実際に保存されている時刻との間に不一致が生じることがあります。この不一致は、次のように解決できます。

- 新規データの場合：Kibana の [Advanced Settings] ページで dateFormat:tz 設定を変更し、目的のタイムゾーンを指定します。

- 既存データの場合：Reindex API を使用してタイムスタンプを更新してください。

Elasticsearch にアクセス可能で Kibana にアクセス不可な場合

Kibana ノードを再起動してください。Elasticsearch インスタンスの 基本情報 ページの ノード可視化 セクションで、Kibana ノード のステータスランプにカーソルを合わせ、再起動 をクリックしてください。

CNAME レコードを使用した Kibana へのアクセス不可問題

[クラウドネイティブの新しいコントロール (v3)] アーキテクチャの Elasticsearch インスタンスでは、CNAME レコードを持つカスタムドメイン名を使用して Kibana にアクセスすることはできません。カスタムドメイン名を使用するには、「Nginx プロキシ経由で Kibana にアクセスする」をご参照ください。

Kibana のログクエリページで KQL を使用して 1 つまたは複数の IP アドレスを除外する方法

Kibana の [Discover] ページまたはログクエリページで、Kibana クエリ言語 (KQL) の NOT キーワードを使用して、指定されたフィールド値に一致するドキュメントを除外できます。このキーワードは、単一値と複数値の両方の除外をサポートしています。

• 単一の IP アドレスを除外するには、NOT <field>: "<IP>" の形式を使用してください。例：

  NOT remote: "10.1.146.35"

• 複数の IP アドレスを除外するには、複数の NOT 条件を AND で連結してください。例：

  NOT remote: "10.1.146.35" AND NOT remote: "10.1.150.19"

KQL の構文の詳細については、Kibana の公式ドキュメント「Kibana Query Language」をご参照ください。