Create a custom visual in a Real-Time Dashboard (Preview)

Use the custom visual to create a purpose-built visualization from a natural-language description. Copilot generates a Kusto Query Language (KQL) query and an HTML-based visualization, and then renders the result in a Real-Time Dashboard tile.

Important

This feature is in preview.

Prerequisites

Note

Add a custom visual

Add a custom visual tile to a dashboard that you're editing.

  1. Open a Real-Time Dashboard.

  2. In the top menu, switch to Editing mode.

  3. From the ribbon, select Add visual > Describe a visual.

    Screenshot of the Real-Time Dashboard ribbon with Add visual and Describe a visual highlighted.

Describe the visualization

Tell Copilot what you want to see. Include the operational question, relevant measures, dimensions, and time range so that Copilot can generate an accurate query and visual.

  1. In the Copilot pane, describe the visualization that you want to create.
  2. Include the operational question, relevant measures, dimensions, and time range in your description.
  3. Submit the prompt.

For example:

  • "Show service health as a transit-map-style operational status board."
  • "Create a weather-style operational summary for the last 24 hours."
  • "Create a map of storm events by latitude and longitude."

You can set the database as the prompt context.

Copilot adds a new visual on the current page and generates:

  • A KQL query that retrieves the required data.

  • An HTML-based visualization that uses the query results.

    Screenshot of a generated AI custom visual with the prompt results and generated query.

Review and refine the visual

Iterate with follow-up prompts until the visual answers your operational question.

  1. Review the generated visualization.

  2. Select the Edit icon on the tile to enter tile edit mode and review the query and visual.

  3. Use the Copilot pane to refine the visual or query.

    Screenshot of a custom visual tile in edit mode with Copilot options for refining the visual or query.

    Note

    The custom visual creates one generated visualization experience per tile.

Save and view the visual

Add the visual to the dashboard, and then confirm that it renders in viewing mode.

  1. Select Apply to save your tile changes.
  2. Resize or reposition the tile as needed.
  3. Save the dashboard.
  4. Switch to viewing mode and confirm that the visual renders as expected.