IBM Cloud Logs ゲージ・ウィジェットの作成

カスタム IBM® Cloud Logs ダッシュボードに含めることができるゲージウィジェットを作成できます。

ゲージウィジェットを使用して、指定された範囲内の単一の値を表示し、多くの場合、速度計やダイヤルに似ています。 一般的に、主要な指標やパフォーマンス指標を一目で表すために使用される。

ゲージにはしきい値が組み込まれており、特定の値が満たされたとき、または超過したときに可視化の外観を変更することができます。 データセットを特定のパラメータでグループ化すると、各ゲージがデータのサブセットを表すマルチゲージが作成されます。 これにより、異なるカテゴリーやグループ間での同時比較が可能になり、より広い視野でパフォーマンスを見ることができる。

ステップ1：名前と説明を入力

以下のステップを実行します。

  1. カスタム・ダッシュボード で、 「ウィジェットの追加」 「ウィジェットの追加」アイコン をクリックし、サイド・バーから 「ゲージ」 ウィジェットをドラッグ・アンド・ドロップします。

  2. New gaugeをウィジェットの名前に置き換えます。

  3. 説明を入力します。

    アクションアイコンをクリックアクションアイコン。 次に、 Add descriptionを選択する。

  4. 凡例値を表示する場所を定義する。 有効な値は Side Bottom、 Auto、 Hide。

    アクションアイコンをクリックアクションアイコン。 次に、 Leggend Settingsを選択する。

ステップ2：データセットを定義するクエリーの設定

以下のステップを実行します。

  1. アクションアイコンをクリックアクションアイコン。 次に、 編集モードを選択する。

  2. Query 1 の場合、以下のステップを完了する：

    データタイプを選択する。 有効な値は Logs Metrics および DataPrime。

    ソースを選択する。 有効なオプションは Priority Insights と Analyze and Alert。

    クエリー名を変更することができます。 アクションアイコン 選択し、 クエリの名前の変更をクリックします。

  3. クエリーを入力する。

    データ・タイプが DataPrime の場合、 Query フィールドに Dataprime クエリを入力する。

    データ型が Logs の場合、 Query フィールドに Lucene クエリを入力します。 フィルターや集計を適用できる。

    データ・タイプが Metrics の場合、 Query フィールドでメトリックまたは希望する PromQL を指定する。 フィルターや集計を適用できる。

  4. [オプション]ゲージに表示されるデータを絞り込むために、ウィジェットに固有の1つまたは複数のフィルタを追加します。

    ラベルと対応する値を選択する。

    フィルタはウィジェットレベルで適用され、ダッシュボードのフィルタと同様に機能します。 競合がある場合、ダッシュボードフィルタがウィジェットフィルタよりも優先されます。

  5. 機能を追加する。

    データ型が Logs のクエリでは、以下の関数のいずれかを使用して集約値を表示できます：

    データ型がログの場合、クエリを作成する際の集計オプション
    集計 説明
    数 選択した時間範囲内のログの総数。
    非重複値の個数 選択した時間範囲内のユニークなログの数。
    合計 選択した時間範囲内のすべてのログの合計。
    最小 選択した時間範囲内のログの中で最小の値。
    最大 選択した時間範囲内のログの中で最大の値。
    平均 選択した時間範囲内のすべてのログの平均値。
    パーセンタイルXX ログのXX％以下になる値を表す。 例えば、パーセンタイル95は、ログの95％が該当する値以下である。

    データ型が Metrics のクエリでは、以下の関数のいずれかを使用して計算値を表示できます：

    データ型がMetricsの場合、クエリ構築時に計算オプションを選択できる。
    計算 説明
    インスタント 現在の時点での値。
    最後 選択した時間範囲内の最新の値。
    最小 選択した時間範囲内の最小値。
    最大 選択した時間範囲内で最大の値。
    平均 選択した時間範囲内の全データポイントの平均値。
    合計 選択した時間範囲内の全データポイントの合計。
    なし 計算は適用されない。 生データを使用する。

  6. Group Byに 1つ以上のフィールドを追加して、複数のゲージを生成する。

ステップ 3: ウィジェットの設定

以下のステップを実行します。

  1. アクションアイコンをクリックアクションアイコン。 次に、 編集モードを選択する。

  2. レジェンド管理オプションを選択します。 有効な値は Group と Threshold。

    グループは、サーバーやアプリケーションなどの異なるデータ・エンティティに基づいて凡例を整理し、それぞれを別の項目として表示する。

    しきい値は、正常、警告、重要など、あらかじめ定義された限界値に基づいて値を分類し、指標が許容範囲内にあるのか、警告状態に入ったのかを可視化するのに役立ちます。

  3. ビジュアルマネジメントセクションで、thaのデータをどのようにビジュアル化するかを選択します。

    内側の弧は、クエリの実際の値を表示します。

    外側の円弧は、あなたが定義したしきい値を表示します。

    内側のアーク、 外側のアーク、またはその両方を有効にして、指定した範囲内の単一の値を表示する。

    内側の円弧と 外側の円弧が無効になっている場合、クエリの数値結果は、追加の視覚化なしで STATウィジェットとして表示されます。 この場合、閾値の色を値に適用するか背景に適用するかを決めることができる。 この部分では、 閾値の色を設定します。 値のしきい値を設定するには Valueを、しきい値の色で背景を設定するには Backgroundを選択します。

  4. Thresholds セクションを設定する。

    しきい値とは設定した値のことで、その値を超えると、クエリ結果に基づいてビジュアリゼーションの外観が変化します。 値はパーセントか絶対数のどちらかを選ぶことができる。

    しきい値のタイプを選択する。 有効なオプションは、 absolute で特定の数値を値として定義し、 percentage で最小値または最大値からの相対値を定義する。

    しきい値の色を変更することができます。

    閾値の値を設定し、それを説明するラベルを追加することができます。

    しきい値を追加することもできる。

ステップ 4: ウィジェットを保存する

以下のステップを実行します。

  1. [オプション]ダッシュボードで選択した時間範囲と異なる時間範囲を使用したい場合は、ウィジェットのダッシュボード時間を設定します。

  2. 保存をクリックしてウィジェットを保存します。

  3. [オプション]ウィジェットへの直接リンクを共有する。 アクションアイコンをクリックアクションアイコン。 次に、 Share Widget URL を選択し、 URL をコピーする。

    ダッシュボードにアクセスできる人なら誰でも、共有リンクを開いてウィジェットをコンテクストで見ることができる。

    共有ウィジェットのURLは、常にダッシュボードの最後に保存されたバージョンを反映します。 ウィジェットやレイアウトに変更を加えた場合は、共有する前にダッシュボードを保存してください。

  4. [オプション]カスタムアクションを追加する。 詳細については、 サードパーティ・サービスと統合するためのアクションの 使用を参照してください。