IBM Cloud Logs カスタムダッシュボードの作成

IBM® Cloud Logs のダッシュボードをカスタマイズして作成できます。

ダッシュボード・ウィジェット

カスタム・ダッシュボードはウィジェットで構成されています。 ダッシュボードで使用するウィジェットを作成することができます。

カスタム・ダッシュボードの作成

カスタムダッシュボードを作成するには、以下の手順に従ってください。

  1. 「ダッシュボード」 アイコン 「ダッシュボード」アイコン > 「カスタム・ダッシュボード」 をクリックします。

  2. 「新規」 > 「新規ダッシュボードの作成」 をクリックして、新規ダッシュボードを作成します。

  3. ウィジェットを新規ダッシュボードにドラッグします。

  4. 「保存」 の上にカーソルを移動し、 「名前を付けて保存」 をクリックします。

  5. 新規ダッシュボードの名前を入力し、 「保存」 をクリックします。

  6. ダッシュボード・パネルで、新しいダッシュボードの上にカーソルを移動し、3 つのドットをクリックします。 ダッシュボードで実行する操作をクリックします: お気に入り、 デフォルトとして設定、 名前の変更、 削除、 名前を付けて保存、 エクスポート、または URL のコピー。

    「お気に入り」 および 「デフォルトとして設定」 の設定は、ユーザーごとに固有です。 他のすべての設定は、すべてのチーム・メンバーに適用されます。

セクションの作成

ウィジェットはセクションに編成できます。 ダッシュボード内のセクションは、縮小、展開、および再配列することができます。

ダッシュボードを保存すると、最後に表示したセクションが省略または展開された状態でダッシュボードが保存されます。 展開されたセクションのウィジェットは、ダッシュボードが表示されるときに最初にロードされます。

  1. 「ダッシュボード」 アイコン 「ダッシュボード」アイコン > 「カスタム・ダッシュボード」 をクリックします。

  2. サイド・バーで、使用可能なすべてのダッシュボードを表示します。

  3. 必要に応じて、表示または変更するダッシュボードをクリックします。

  4. 「セクション」 をドラッグ・アンド・ドロップして、ダッシュボードにセクションを作成します。

  5. 「新規セクション」 をクリックし、セクション名を入力して、セクションに名前を付けます。

  6. ウィジェットをセクションにドラッグ・アンド・ドロップします。

  7. これらのステップを繰り返して、新しいセクションとウィジェットを作成します。

  8. 変更が完了したら、 「保存」 または 「名前を付けて保存」 をクリックします。 これにより、ダッシュボード全体が保存されます。 「元に戻す」 をクリックして変更を元に戻し、以前に保存したダッシュボードを表示します。

  9. ダッシュボード・パネルで、新しいダッシュボードの上にカーソルを移動し、3 つのドットをクリックします。 ダッシュボードで実行する操作をクリックします: お気に入り、 デフォルトとして設定、 名前の変更、 削除、 名前を付けて保存、 エクスポート、または URL のコピー。

    「お気に入り」 および 「デフォルトとして設定」 の設定は、ユーザーごとに固有です。 他のすべての設定は、すべてのチーム・メンバーに適用されます。

ダッシュボードの時間フレームの指定

デフォルトでは、カスタム・ダッシュボードには過去 15 分間のデータが表示されます。 これは、ダッシュボードの時間フレーム・ドロップダウンを使用して変更できます。

異なる時間フレームを選択するには、いずれかのクイック時間フレームを選択するか、 「カスタム」 タブを使用してデータを表示する 2 つの日付を選択します。

IBM® Cloud Logs カスタムダッシュボードでは、最大90日間の期間を選択できます。 これにより、カスタム・ダッシュボード内で、保存期間が長いメトリック・ウィジェットを簡単に表示できます。

時間フレームの制限は、データ・ソースとデータ起点に応じて適用されます。 7 日を超える期間を選択すると、「探索」画面の時間制限と同様に、各データ・ソースの特定の設定に基づいて結果が表示されます。

例えば、「ログの探索 (Explore logs)」画面のログが最大 8 日間の時間フレームで制限されている場合、これはカスタム・ダッシュボードにも当てはまります。 同じダッシュボードに最大 90 日分のデータを表示できるメトリックではなく、過去 8 日間のログ・データのみが表示されます。

照会範囲および保存期間は、それぞれ注釈行でマークされます。 線の上にカーソルを移動すると、説明が表示されます。

例えば、保存期間が 21 日の場合、ユーザーはその制限を時系列ウィジェットで確認することができ、その 21 日以内に古い 7 日間の時刻照会を選択しても結果が返されます。

カスタム・ダッシュボードの変更

ウィジェットは、ダッシュボードに表示されると常に編集モードになり、いつでも編集できます。

  1. 「ダッシュボード」 アイコン 「ダッシュボード」アイコン > 「カスタム・ダッシュボード」 をクリックします。

  2. サイド・バーで、使用可能なすべてのダッシュボードを表示します。

  3. 必要に応じて、表示または変更するダッシュボードをクリックします。

    ドロップダウン・メニューの 「保存」 の上にカーソルを移動すると、 「保存」 または 「名前を付けて保存」 のいずれかを選択するオプションが表示されます。 「保存」 をクリックすると、現在のダッシュボードが変更されます。 「名前を付けて保存」 を選択すると、ダッシュボードの新規コピーが作成され、変更内容がそのまま保存されます。

    「名前を付けて保存」 を選択すると、新規ダッシュボードに名前を付ける必要があるポップアップが表示されます。

  4. 必要に応じてダッシュボード・ウィジェットを変更します。

    ダッシュボード内の特定のウィジェットを展開するには、ウィジェットの隅にある「展開」アイコンをクリックします。 これにより、一時的にウィジェットがダッシュボード全体に拡張されます。

    すべてのウィジェットの隅に 3 つのドットがあります。 3 つのドットをクリックし、 「編集」、 「削除」、 「複製」、 「アラートの作成」 、および 「メトリックの作成」 のメニュー・オプションから選択します。 折れ線グラフの場合は、 「凡例を非表示にする」 オプションもあります。

    折れ線グラフの凡例内の値を右クリックすると、コンテキスト・メニューが開き、以下のオプションが表示されます。

    除外: この値を現行フィルターから除外します。

    含める: この値をフィルターに含めます。

    コピー名: 照会または検索で使用する時系列の名前をコピーすることができます。

  5. ウィジェットに変更を加えたら、 「保存」 または 「別名保存」 をクリックします。 これにより、ダッシュボード全体が保存されます。 「元に戻す」 をクリックして変更を元に戻し、以前に保存したダッシュボードを表示します。

  6. ダッシュボード・パネルで、新しいダッシュボードの上にカーソルを移動し、3 つのドットをクリックします。 ダッシュボードで実行する操作をクリックします: お気に入り、 デフォルトとして設定、 名前の変更、 削除、 名前を付けて保存、 エクスポート、または URL のコピー。

    「お気に入り」 および 「デフォルトとして設定」 の設定は、ユーザーごとに固有です。 他のすべての設定は、すべてのチーム・メンバーに適用されます。

カスタムダッシュボード構成のエクスポートとインポート

カスタムダッシュボードの設定をエクスポートし、IBM Cloud Logsインスタンスにインポートすることができます。

ダッシュボードのエクスポート

ダッシュボード構成をエクスポートするには

  1. 「ダッシュボード」 アイコン 「ダッシュボード」アイコン > 「カスタム・ダッシュボード」 をクリックします。

  2. エクスポートするダッシュボードを開きます。

  3. Actions アイコン Actionsアイコン Actions > Export as JSONをクリックします。

    エクスポートされたJSONファイルの名前が表示されます。 ファイルが作成された日付が名前に含まれる。

  4. **「エクスポート」**をクリックします。

    ファイルはローカルシステムに書き込まれます。

ダッシュボードのインポート

エクスポートされたダッシュボード構成をインポートするには：

  1. 「ダッシュボード」 アイコン 「ダッシュボード」アイコン > 「カスタム・ダッシュボード」 をクリックします。

  2. [ 新規 ] > [ ダッシュボードのインポート ] をクリックします。

  3. システムからエクスポートされたダッシュボード構成ファイルを選択します。

    ファイルをアップロードせずに、JSONを直接貼り付けることもできます。

  4. インポート をクリックします。

ダッシュボードに定義されているすべてのウィジェットのデータソースを変更する

デフォルトでは、カスタムダッシュボードは 優先順位の洞察 からのデータを処理するウィジェットで作成されますが、ウィジェットにすべてのログからのデータを処理させたい場合もあります。 定義されたダッシュボードのすべてのウィジェットのデータ・ソースは、以下の手順で簡単に変更できます。

  1. 変更するダッシュボードを エクスポート します。

  2. エクスポートされたJSONファイルを編集し、すべての dataModeType 参照の値を目的のデータソースに変更する：

    • DATA_MODE_TYPE_HIGH_UNSPECIFIED にとって 優先順位の洞察

    • DATA_MODE_TYPE_ARCHIVE すべてのログ

  3. 変更したダッシュボード JSON ファイルを インポート します。

  4. (オプション）：インポートされたダッシュボードの名前を変更することで、データが 優先順位の洞察 または All Logs のどちらから取得されたかを理解しやすくすることができます。

  5. (オプション）：不要になったデータ ソースからデータを取得していた元のカスタム ダッシュボードを削除します。

変数の作成

ダッシュボードから、ウィジェットの照会言語で使用できる変数を作成できます。

  1. ダッシュボードの隅にある「変数の追加」アイコン [x] をクリックします。

  2. 「変数タイプ」、 「フィールド」、 「変数名」、および 「表示名」 を定義して、変数を定義します。

  3. 保存 をクリックします。

  4. 画面の隅にある各 「フィールド」 の変数を表示します。

これで、ウィジェット照会言語で変数名を使用できるようになりました。

Luceneまたは DataPrime のクエリに値を入力してください。 値が変更されると、すべてのウィジェットが影響を受けます。

フィルターの作成

デフォルトでは、アプリケーション・フィルターとサブシステム・フィルターが作成されます。 追加のフィルターを作成するオプションがあります。

フィルターが有効になっている場合、ログ・ベースのウィジェットのみがフィルタリングされます。

フィルター名の横にあるトグルをクリックして、フィルターを無効にします。

  1. サイドバーの 「フィルターの管理」 「フィルターの管理」アイコン をクリックします。

  2. 「 + 新しいフィルター 」をクリックします。

  3. フィルターのパラメーター ( 「ソース」、 「フィールド」、および 「演算子」) を定義します。

  4. 保存 をクリックします。

カスタム・ダッシュボードの使用に関する注意事項

  • ユーザーはすべてのダッシュボードにアクセスできます。 編集権限を持つユーザーは、すべてのダッシュボードを編集できます。

  • ログ・フィルターは、ログ・ベースのウィジェットに適用されます。

  • ダッシュボードで定義された変数には、すべてのウィジェットからアクセスできます。

  • ウィジェットの編集時には、現在編集中のウィジェットが強調表示され、他のすべてのウィジェットが色付きで表示されます。

さまざまなウィジェット・タイプとその定義の説明について詳しくは、以下を参照してください。