IBM Cloud Logs ダイナミック・ウィジェットの作成

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

このウィジェットを使用して、クエリデータ結果に基づいて提案されるビジュアライゼーションの提案を取得し、データ結果を表示する最適な方法を見つけます。 Lucene クエリ、 DataPrime クエリ、 PromQL クエリを設定できます。

仕組みについて

ダイナミック・ウィジェットは、クエリ結果を分析し、データの形状に基づいてビジュアライゼーションを提案する。

デフォルトでは、ダッシュボードに初めてダイナミック・ウィジェットを追加すると、テーブル・ビューが表示されます。 生データはJSON形式で表示される。

次に、クエリーフィルター、グループ化、集計を適用することができます。 フィルタリングされたデータは、棒グラフ、円グラフ、ゲージ、折れ線グラフなどのビジュアライゼーションを提案するために使用されます。

クエリが変更されるたびに、ダイナミックウィジェットは結果を再分析し、推奨ビジュアライゼーションのリストを更新します。

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

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

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

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

  3. 説明を入力します。

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

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

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

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

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

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

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

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

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

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

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

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

ステップ3：視覚化ウィジェットを選択する

クエリーを入力した後

  1. Suggest Visualizations をクリックすると、有効なビジュアライゼーションのリストが表示されます。

  2. このウィジェットでデータを表示する可視化を1つ選択します。 次に、そのビジュアライゼーション用にウィジェットを設定します。 可視化のカスタマイズについては、各可視化タイプの情報を参照してください：

ステップ4：1つ以上のルールを追加する

異なるプロパティを持つ新しいルールを追加するには、 ［Add Rule ］を選択する。

**Thresholds.**: Choose the base **Thresholds**. That is, when the gauge should appear green and red. Add additional thresholds - yellow and orange - if necessary.

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

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

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

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

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

既知の制限事項

  • ダイナミックウィジェットは、クエリ結果ごとに最大2,000レコードを表示します。

    クエリが2,000以上のレコードを返すと、ウィジェットは Partial Data 通知を表示します。 ウィジェットには、返された最初の2,000行のみが含まれる。

    完全な結果セットを分析するには、時間範囲を狭めるか、フィルタを適用して返されるレコードの数を減らします。

  • テーブル・ウィジェットについては、以下の制限が適用されます：

    Filter In または Filter Out を使用したデータとのやり取りは、 URL には含まれず、リンクを共有しても永続化されません。

    外側joinのようなjoinを持つ複数クエリテーブルがある場合、 Filter In 、 Filter Out。

    構造化カラムを持つテーブル・ウィジェットのみをフィルタリングできます。 テキストまたはJSONコンテンツを含むカラムは生データを表示し、カラムベースのフィルタリングやフィルタアクションをサポートしません。