Skip to main content

topic_discovery_topic_with_cluster_points

Creates, updates, deletes, gets or lists a topic_discovery_topic_with_cluster_points resource.

Overview

Nametopic_discovery_topic_with_cluster_points
TypeResource
Iddatadog.llm_observability.topic_discovery_topic_with_cluster_points

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringIdentifier of the run the topics belong to. (example: 3fd6b5e0-8910-4b1c-a7d0-5b84de329012)
attributesobjectAttributes of an Agent Observability patterns topics-with-clustered-points response.
typestringResource type of an Agent Observability patterns topics-with-clustered-points response. (get_topics_with_cluster_points_response) (example: get_topics_with_cluster_points_response)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_llmobs_patterns_topics_with_clustered_pointsselectconfig_idrun_id, include_metricsList the topics discovered by a patterns run, with the clustered points attached<br />inline to each leaf topic. When no run is specified, the most recent completed<br />run is used.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
config_idstringThe ID of the patterns configuration. (example: a7c8d9e0-1234-5678-9abc-def012345678)
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
include_metricsbooleanWhen true, enrich each clustered point with span metrics such as status, duration, token counts, estimated cost, and evaluations.
run_idstringThe ID of a specific patterns run. Defaults to the most recent completed run. (example: 3fd6b5e0-8910-4b1c-a7d0-5b84de329012)

SELECT examples

List the topics discovered by a patterns run, with the clustered points attached<br />inline to each leaf topic. When no run is specified, the most recent completed<br />run is used.

SELECT
id,
attributes,
type
FROM datadog.llm_observability.topic_discovery_topic_with_cluster_points
WHERE config_id = '{{ config_id }}' -- required
AND run_id = '{{ run_id }}'
AND include_metrics = '{{ include_metrics }}'
;