--- title: Update a dashboard description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Dashboards --- # Update a dashboard{% #update-a-dashboard %} {% tab title="v1" %} | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------- | | ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id} | | ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id} | | app.datadoghq.eu | PUT https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id} | | app.ddog-gov.com | PUT https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id} | | us2.ddog-gov.com | PUT https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id} | | app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/dashboard/{dashboard_id} | | us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id} | | us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id} | ### Overview Update a dashboard using the specified ID. This endpoint requires the `dashboards_write` permission. OAuth apps require the `dashboards_write` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#dashboards) to access this endpoint. ### Arguments #### Path Parameters | Name | Type | Description | | ------------------------------ | ------ | ------------------------ | | dashboard_id [*required*] | string | The ID of the dashboard. | ### Request #### Body Data (required) Update Dashboard request body. {% tab title="Model" %} | Parent field | Field | Type | Description | | ------------------------- | ------------------------------------------ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | author_handle | string | Identifier of the dashboard author. | | | author_name | string | Name of the dashboard author. | | | created_at | date-time | Creation date of the dashboard. | | | description | string | Description of the dashboard. | | | id | string | ID of the dashboard. | | | is_read_only | boolean | **DEPRECATED**: Whether this dashboard is read-only. If True, only the author and admins can make changes to it. | This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies.md) instead to manage write authorization for individual dashboards. | | | layout_type [*required*] | enum | Layout type of the dashboard. Allowed enum values: `ordered,free` | | | modified_at | date-time | Modification date of the dashboard. | | | notify_list | [string] | List of handles of users to notify when changes are made to this dashboard. | | | reflow_type | enum | Reflow type for a **new dashboard layout** dashboard. Set this only when layout type is 'ordered'. If set to 'fixed', the dashboard expects all widgets to have a layout, and if it's set to 'auto', widgets should not have layouts. Allowed enum values: `auto,fixed` | | | restricted_roles | [string] | A list of role identifiers. Only the author and users associated with at least one of these roles can edit this dashboard. | | | tabs | [object] | List of tabs for organizing dashboard widgets into groups. | | tabs | id [*required*] | uuid | UUID of the tab. | | tabs | name [*required*] | string | Name of the tab. | | tabs | widget_ids [*required*] | [integer] | List of widget IDs belonging to this tab. The backend also accepts positional references in @N format (1-indexed) as a convenience for Terraform and other declarative tools. | | | tags | [string] | List of team names representing ownership of a dashboard. | | | template_variable_presets | [object] | Array of template variables saved views. | | template_variable_presets | name | string | The name of the variable. | | template_variable_presets | template_variables | [object] | List of variables. | | template_variables | name | string | The name of the variable. | | template_variables | value | string | **DEPRECATED**: (deprecated) The value of the template variable within the saved view. Cannot be used in conjunction with `values`. | | template_variables | values | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. Cannot be used in conjunction with `value`. | | | template_variables | [object] | List of template variables for this dashboard. | | template_variables | available_values | [string] | The list of values that the template variable drop-down is limited to. | | template_variables | default | string | **DEPRECATED**: (deprecated) The default value for the template variable on dashboard load. Cannot be used in conjunction with `defaults`. | | template_variables | defaults | [string] | One or many default values for template variables on load. If more than one default is specified, they will be unioned together with `OR`. Cannot be used in conjunction with `default`. | | template_variables | name [*required*] | string | The name of the variable. | | template_variables | prefix | string | The tag prefix associated with the variable. Only tags with this prefix appear in the variable drop-down. | | template_variables | type | string | The type of variable. This is to differentiate between filter variables (interpolated in query) and group by variables (interpolated into group by). | | | title [*required*] | string | Title of the dashboard. | | | url | string | The URL of the dashboard. | | | widgets [*required*] | [object] | List of widgets to display on the dashboard. | | widgets | definition [*required*] | | [Definition of the widget](https://docs.datadoghq.com/dashboards/widgets.md). | | definition | Option 1 | object | Alert graphs are timeseries graphs showing the current status of any monitor defined on your system. | | Option 1 | alert_id [*required*] | string | ID of the alert to use in the widget. | | Option 1 | description | string | The description of the widget. | | Option 1 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 1 | title | string | The title of the widget. | | Option 1 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 1 | title_size | string | Size of the title. | | Option 1 | type [*required*] | enum | Type of the alert graph widget. Allowed enum values: `alert_graph` | | Option 1 | viz_type [*required*] | enum | Whether to display the Alert Graph as a timeseries or a top list. Allowed enum values: `timeseries,toplist` | | definition | Option 2 | object | Alert values are query values showing the current value of the metric in any monitor defined on your system. | | Option 2 | alert_id [*required*] | string | ID of the alert to use in the widget. | | Option 2 | description | string | The description of the widget. | | Option 2 | precision | int64 | Number of decimal to show. If not defined, will use the raw value. | | Option 2 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title | string | Title of the widget. | | Option 2 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title_size | string | Size of value in the widget. | | Option 2 | type [*required*] | enum | Type of the alert value widget. Allowed enum values: `alert_value` | | Option 2 | unit | string | Unit to display with the value. | | definition | Option 3 | object | The bar chart visualization displays categorical data using vertical bars, allowing you to compare values across different groups. | | Option 3 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 3 | description | string | The description of the widget. | | Option 3 | requests [*required*] | [object] | List of bar chart widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 3 | style | object | Style customization for a bar chart widget. | | style | display | | Bar chart widget display options. | | display | Option 1 | object | Bar chart widget stacked display options. | | Option 1 | legend | enum | Bar chart widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Bar chart widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Bar chart widget flat display. | | Option 2 | type [*required*] | enum | Bar chart widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Bar chart widget scaling definition. Allowed enum values: `absolute,relative` | | Option 3 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 3 | title | string | Title of your widget. | | Option 3 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 3 | title_size | string | Size of the title. | | Option 3 | type [*required*] | enum | Type of the bar chart widget. Allowed enum values: `bar_chart` | | definition | Option 4 | object | The Change graph shows you the change in a value over the time period chosen. | | Option 4 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 4 | description | string | The description of the widget. | | Option 4 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | change_type | enum | Show the absolute or the relative change. Allowed enum values: `absolute,relative` | | requests | compare_to | enum | Timeframe used for the change comparison. Allowed enum values: `hour_before,day_before,week_before,month_before` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | increase_good | boolean | Whether to show increase as good. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order_by | enum | What to order by. Allowed enum values: `change,name,present,past` | | requests | order_dir | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | show_present | boolean | Whether to show the present value. | | Option 4 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 4 | title | string | Title of the widget. | | Option 4 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | title_size | string | Size of the title. | | Option 4 | type [*required*] | enum | Type of the change widget. Allowed enum values: `change` | | definition | Option 5 | object | Check status shows the current status or number of results for any check performed. | | Option 5 | check [*required*] | string | Name of the check to use in the widget. | | Option 5 | description | string | The description of the widget. | | Option 5 | group | string | Group reporting a single check. | | Option 5 | group_by | [string] | List of tag prefixes to group by in the case of a cluster check. | | Option 5 | grouping [*required*] | enum | The kind of grouping to use. Allowed enum values: `check,cluster` | | Option 5 | tags | [string] | List of tags used to filter the groups reporting a cluster check. | | Option 5 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 5 | title | string | Title of the widget. | | Option 5 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 5 | title_size | string | Size of the title. | | Option 5 | type [*required*] | enum | Type of the check status widget. Allowed enum values: `check_status` | | definition | Option 6 | object | The cohort widget visualizes user retention over time. | | Option 6 | description | string | The description of the widget. | | Option 6 | requests [*required*] | [object] | List of Cohort widget requests. | | requests | query [*required*] | object | Retention query definition. | | query | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | query | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | query | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | query | name | string | Name of the query. | | query | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | request_type [*required*] | enum | Request type for retention grid widget. Allowed enum values: `retention_grid` | | Option 6 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 6 | title | string | Title of your widget. | | Option 6 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 6 | title_size | string | Size of the title. | | Option 6 | type [*required*] | enum | Type of the Cohort widget. Allowed enum values: `cohort` | | definition | Option 7 | object | The Distribution visualization is another way of showing metrics aggregated across one or several tags, such as hosts. Unlike the heat map, a distribution graph's x-axis is quantity rather than time. | | Option 7 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 7 | description | string | The description of the widget. | | Option 7 | legend_size | string | **DEPRECATED**: (Deprecated) The widget legend was replaced by a tooltip and sidebar. | | Option 7 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 7 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | | Query definition for Distribution Widget Histogram Request | | query | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | query | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | query | Option 3 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 3 | env [*required*] | string | APM environment. | | Option 3 | group_by | [string] | Array of fields to group results by. | | Option 3 | name [*required*] | string | Name of this query to use in formulas. | | Option 3 | operation_name | string | Name of operation on service. | | Option 3 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 3 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 3 | resource_name | string | APM resource name. | | Option 3 | service [*required*] | string | APM service name. | | Option 3 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | query | Option 4 | object | A formula and functions APM metrics query. | | Option 4 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 4 | group_by | [string] | Optional fields to group the query results by. | | Option 4 | name [*required*] | string | Name of this query to use in formulas. | | Option 4 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 4 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 4 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 4 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 4 | resource_hash | string | The hash of a specific resource to filter by. | | Option 4 | resource_name | string | The full name of a specific resource to filter by. | | Option 4 | service | string | APM service name. | | Option 4 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 4 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | requests | request_type | enum | Distribution of point values for distribution metrics. Renders a histogram of raw metric data points. Allowed enum values: `histogram` | | requests | response_format | enum | Distribution of aggregated grouped queries. Use `request_type` instead for distribution of point values from distribution metrics. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 7 | show_legend | boolean | **DEPRECATED**: (Deprecated) The widget legend was replaced by a tooltip and sidebar. | | Option 7 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 7 | title | string | Title of the widget. | | Option 7 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 7 | title_size | string | Size of the title. | | Option 7 | type [*required*] | enum | Type of the distribution widget. Allowed enum values: `distribution` | | Option 7 | xaxis | object | X Axis controls for the distribution widget. | | xaxis | include_zero | boolean | True includes zero. | | xaxis | max | string | Specifies maximum value to show on the x-axis. It takes a number, percentile (p90 === 90th percentile), or auto for default behavior. | | xaxis | min | string | Specifies minimum value to show on the x-axis. It takes a number, percentile (p90 === 90th percentile), or auto for default behavior. | | xaxis | num_buckets | int64 | Number of value buckets to target, also known as the resolution of the value bins. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`. | | Option 7 | yaxis | object | Y Axis controls for the distribution widget. | | yaxis | include_zero | boolean | True includes zero. | | yaxis | label | string | The label of the axis to display on the graph. | | yaxis | max | string | Specifies the maximum value to show on the y-axis. It takes a number, or auto for default behavior. | | yaxis | min | string | Specifies minimum value to show on the y-axis. It takes a number, or auto for default behavior. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear` or `log`. | | definition | Option 8 | object | The event stream is a widget version of the stream of events on the Event Stream view. Only available on FREE layout dashboards. | | Option 8 | description | string | The description of the widget. | | Option 8 | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | Option 8 | query [*required*] | string | Query to filter the event stream with. | | Option 8 | tags_execution | string | The execution method for multi-value filters. Can be either and or or. | | Option 8 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 8 | title | string | Title of the widget. | | Option 8 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 8 | title_size | string | Size of the title. | | Option 8 | type [*required*] | enum | Type of the event stream widget. Allowed enum values: `event_stream` | | definition | Option 9 | object | The event timeline is a widget version of the timeline that appears at the top of the Event Stream view. Only available on FREE layout dashboards. | | Option 9 | description | string | The description of the widget. | | Option 9 | query [*required*] | string | Query to filter the event timeline with. | | Option 9 | tags_execution | string | The execution method for multi-value filters. Can be either and or or. | | Option 9 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 9 | title | string | Title of the widget. | | Option 9 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 9 | title_size | string | Size of the title. | | Option 9 | type [*required*] | enum | Type of the event timeline widget. Allowed enum values: `event_timeline` | | definition | Option 10 | object | Free text is a widget that allows you to add headings to your dashboard. Commonly used to state the overall purpose of the dashboard. | | Option 10 | background_color | string | Background color of the widget. Supported values are `white`, `blue`, `purple`, `pink`, `orange`, `yellow`, `green`, `gray`, `vivid_blue`, `vivid_purple`, `vivid_pink`, `vivid_orange`, `vivid_yellow`, `vivid_green`, and `transparent`. | | Option 10 | color | string | Color of the text. | | Option 10 | font_size | string | Size of the text. | | Option 10 | text [*required*] | string | Text to display. | | Option 10 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 10 | type [*required*] | enum | Type of the free text widget. Allowed enum values: `free_text` | | definition | Option 11 | object | The funnel visualization displays a funnel of user sessions that maps a sequence of view navigation and user interaction in your application. | | Option 11 | description | string | The description of the widget. | | Option 11 | grouped_display | enum | Display mode for grouped funnel results. Allowed enum values: `stacked,side_by_side` | | Option 11 | requests [*required*] | [object] | Request payload used to query items. | | requests | query [*required*] | object | Updated funnel widget. | | query | data_source [*required*] | enum | Source from which to query items to display in the funnel. Allowed enum values: `rum` | | query | query_string [*required*] | string | The widget query. | | query | steps [*required*] | [object] | List of funnel steps. | | steps | facet [*required*] | string | The facet of the step. | | steps | value [*required*] | string | The value of the step. | | requests | request_type [*required*] | enum | Widget request type. Allowed enum values: `funnel` | | Option 11 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 11 | title | string | The title of the widget. | | Option 11 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 11 | title_size | string | The size of the title. | | Option 11 | type [*required*] | enum | Type of funnel widget. Allowed enum values: `funnel` | | definition | Option 12 | object | The user journey funnel visualization displays conversion funnels based on user journey data from Product Analytics. | | Option 12 | description | string | The description of the widget. | | Option 12 | grouped_display | enum | Display mode for grouped funnel results. Allowed enum values: `stacked,side_by_side` | | Option 12 | requests [*required*] | [object] | Request payload used to query items. | | requests | comparison_segments | [string] | Comparison segments. | | requests | comparison_time | object | Comparison time configuration for funnel widgets. | | comparison_time | custom_timeframe | object | Custom timeframe for funnel comparison. | | custom_timeframe | from [*required*] | double | Start of the custom timeframe. | | custom_timeframe | to [*required*] | double | End of the custom timeframe. | | comparison_time | type [*required*] | enum | Type of comparison duration. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | requests | query [*required*] | object | User journey funnel query definition. | | query | compute | object | Compute configuration for user journey funnel. | | compute | aggregation [*required*] | enum | Aggregation type for user journey funnel compute. Allowed enum values: `cardinality,count` | | compute | metric [*required*] | enum | Metric for user journey funnel compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` (unique users/sessions) and `cardinality` (total users/sessions) as aggregations. Allowed enum values: `__dd.conversion,__dd.conversion_rate` | | query | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for user journey funnel group by. | | sort | aggregation [*required*] | string | Aggregation type. | | sort | metric | string | Metric to sort by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | query | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | query | subquery_id | string | Subquery ID. | | requests | request_type [*required*] | enum | Request type for user journey funnel widget. Allowed enum values: `user_journey_funnel` | | Option 12 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 12 | title | string | The title of the widget. | | Option 12 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 12 | title_size | string | The size of the title. | | Option 12 | type [*required*] | enum | Type of funnel widget. Allowed enum values: `funnel` | | definition | Option 13 | object | This visualization displays a series of values by country on a world map. | | Option 13 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 13 | description | string | The description of the widget. | | Option 13 | requests [*required*] | [object] | Array of request objects to display in the widget. May include an optional request for the region layer and/or an optional request for the points layer. Region layer requests must contain a `group-by` tag whose value is a country ISO code. See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) for information about building the `REQUEST_SCHEMA`. | | requests | columns | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | conditional_formats | [object] | Threshold (numeric) conditional formatting rules may be used by a regions layer. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | The style to apply to the request for points layer. | | style | color_by | string | The category to color the points by. | | requests | text_formats | [object] | Text formatting rules may be used by a points layer. | | text_formats | custom_bg_color | string | Hex representation of the custom background color. Used with custom background palette option. | | text_formats | custom_fg_color | string | Hex representation of the custom text color. Used with custom text palette option. | | text_formats | match [*required*] | object | Match rule for the table widget text format. | | match | type [*required*] | enum | Match or compare option. Allowed enum values: `is,is_not,contains,does_not_contain,starts_with,ends_with` | | match | value [*required*] | string | Table Widget Match String. | | text_formats | palette | enum | Color-on-color palette to highlight replaced text. Allowed enum values: `white_on_red,white_on_yellow,white_on_green,black_on_light_red,black_on_light_yellow,black_on_light_green,red_on_white,yellow_on_white,green_on_white,custom_bg` | | text_formats | replace | | Replace rule for the table widget text format. | | replace | Option 1 | object | Match All definition. | | Option 1 | type [*required*] | enum | Table widget text format replace all type. Allowed enum values: `all` | | Option 1 | with [*required*] | string | Replace All type. | | replace | Option 2 | object | Match Sub-string definition. | | Option 2 | substring [*required*] | string | Text that will be replaced. | | Option 2 | type [*required*] | enum | Table widget text format replace sub-string type. Allowed enum values: `substring` | | Option 2 | with [*required*] | string | Text that will replace original sub-string. | | Option 13 | style [*required*] | object | The style to apply to the widget. | | style | palette [*required*] | string | The color palette to apply to the widget. | | style | palette_flip [*required*] | boolean | Whether to flip the palette tones. | | Option 13 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 13 | title | string | The title of your widget. | | Option 13 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 13 | title_size | string | The size of the title. | | Option 13 | type [*required*] | enum | Type of the geomap widget. Allowed enum values: `geomap` | | Option 13 | view [*required*] | object | The view of the world that the map should render. | | view | focus [*required*] | string | The 2-letter ISO code of a country to focus the map on, or `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`). | | definition | Option 14 | object | The group widget allows you to keep similar graphs together on your dashboard. Each group has a custom header, can hold one to many graphs, and is collapsible. | | Option 14 | background_color | string | Background color of the widget. Supported values are `white`, `blue`, `purple`, `pink`, `orange`, `yellow`, `green`, `gray`, `vivid_blue`, `vivid_purple`, `vivid_pink`, `vivid_orange`, `vivid_yellow`, `vivid_green`, and `transparent`. | | Option 14 | banner_img | string | URL of image to display as a banner for the group. | | Option 14 | layout_type [*required*] | enum | Layout type of the group. Allowed enum values: `ordered` | | Option 14 | show_title | boolean | Whether to show the title or not. | | Option 14 | title | string | Title of the widget. | | Option 14 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 14 | type [*required*] | enum | Type of the group widget. Allowed enum values: `group` | | Option 14 | widgets [*required*] | [object] | List of widget groups. | | definition | Option 15 | object | The heat map visualization shows metrics aggregated across many tags, such as hosts. The more hosts that have a particular value, the darker that square is. | | Option 15 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 15 | description | string | The description of the widget. | | Option 15 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 15 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 15 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 15 | requests [*required*] | [object] | List of widget types. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | search [*required*] | string | The query being made on the event. | | event_query | tags_execution [*required*] | string | The execution method for multi-value filters. Can be either and or or. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | object | A formula and functions metrics query. | | query | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | query | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | query | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | query | name [*required*] | string | Name of the query for use in formulas. | | query | query [*required*] | string | Metrics query definition. | | query | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | requests | request_type | enum | Applicable only for distribution of point values for distribution metrics. Allowed enum values: `histogram` | | requests | response_format | enum | Applicable only for distribution of aggregated grouped queries. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 15 | show_legend | boolean | Whether or not to display the legend on this widget. | | Option 15 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 15 | title | string | Title of the widget. | | Option 15 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 15 | title_size | string | Size of the title. | | Option 15 | type [*required*] | enum | Type of the heat map widget. Allowed enum values: `heatmap` | | Option 15 | xaxis | object | X Axis controls for the heat map widget. | | xaxis | num_buckets | int64 | Number of time buckets to target, also known as the resolution of the time bins. This is only applicable for distribution of points (group distributions use the roll-up modifier). | | Option 15 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 16 | object | The host map widget graphs any metric across your hosts using the same visualization available from the main Host Map page. | | Option 16 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 16 | description | string | The description of the widget. | | Option 16 | group | [string] | List of tag prefixes to group by. | | Option 16 | no_group_hosts | boolean | Whether to show the hosts that don't fit in a group. | | Option 16 | no_metric_hosts | boolean | Whether to show the hosts with no metrics. | | Option 16 | node_type | enum | Which type of node to use in the map. Allowed enum values: `host,container` | | Option 16 | notes | string | Notes on the title. | | Option 16 | requests [*required*] | object | Query definition for the host map widget. Supports two mutually exclusive formats distinguished by the presence of `request_type`: the legacy metric-based format (`fill`/`size`) and the infrastructure-backed format (`request_type`, `node_type`, `enrichments`). | | requests | child | object | Infrastructure-backed request for the host map widget. Supports entity-based visualization with metric query enrichments, tag-based filtering, flexible grouping, and hierarchical views. | | child | child | object | Optional child request for hierarchical visualization (for example, hosts containing containers). Maximum one level of nesting. | | child | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | child | enrichments [*required*] | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | unit | Option 2 | object | Custom unit. | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | group_by | target | object | Target for user journey search. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | search | join_keys | object | Join keys for user journey queries. | | search | node_objects [*required*] | object | Node objects mapping. | | search | step_aliases | object | Step aliases mapping. | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | search | filters | object | Filters for retention queries. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | child | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | child | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | child | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | child | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | child | node_type [*required*] | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | child | request_type [*required*] | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | child | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | child | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | child | enrichments [*required*] | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | child | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | child | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | child | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | child | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | child | node_type [*required*] | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | child | request_type [*required*] | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | child | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | requests | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | enrichments | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | requests | fill | object | Updated host map. | | fill | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | fill | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | q | string | Query definition. | | fill | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | requests | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | requests | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | requests | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | requests | node_type | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | requests | request_type | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | requests | size | object | Updated host map. | | size | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | size | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | q | string | Query definition. | | size | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | Option 16 | scope | [string] | List of tags used to filter the map. | | Option 16 | style | object | The style to apply to the widget. | | style | fill_max | string | Max value to use to color the map. | | style | fill_min | string | Min value to use to color the map. | | style | palette | string | Color palette to apply to the widget. | | style | palette_flip | boolean | Whether to flip the palette tones. | | Option 16 | title | string | Title of the widget. | | Option 16 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 16 | title_size | string | Size of the title. | | Option 16 | type [*required*] | enum | Type of the host map widget. Allowed enum values: `hostmap` | | definition | Option 17 | object | The iframe widget allows you to embed a portion of any other web page on your dashboard. | | Option 17 | type [*required*] | enum | Type of the iframe widget. Allowed enum values: `iframe` | | Option 17 | url [*required*] | string | URL of the iframe. | | definition | Option 18 | object | The image widget allows you to embed an image on your dashboard. An image can be a PNG, JPG, or animated GIF. | | Option 18 | has_background | boolean | Whether to display a background or not. | | Option 18 | has_border | boolean | Whether to display a border or not. | | Option 18 | horizontal_align | enum | Horizontal alignment. Allowed enum values: `center,left,right` | | Option 18 | margin | enum | Size of the margins around the image. **Note**: `small` and `large` values are deprecated. Allowed enum values: `sm,md,lg,small,large` | | Option 18 | sizing | enum | How to size the image on the widget. The values are based on the image `object-fit` CSS properties. **Note**: `zoom`, `fit` and `center` values are deprecated. Allowed enum values: `fill,contain,cover,none,scale-down,zoom,fit,center` | | Option 18 | type [*required*] | enum | Type of the image widget. Allowed enum values: `image` | | Option 18 | url [*required*] | string | URL of the image. | | Option 18 | url_dark_theme | string | URL of the image in dark mode. | | Option 18 | vertical_align | enum | Vertical alignment. Allowed enum values: `center,top,bottom` | | definition | Option 19 | object | The list stream visualization displays a table of recent events in your application that match a search criteria using user-defined columns. | | Option 19 | description | string | The description of the widget. | | Option 19 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 19 | requests [*required*] | [object] | Request payload used to query items. | | requests | columns [*required*] | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | query [*required*] | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format [*required*] | enum | Widget response format. Allowed enum values: `event_list` | | Option 19 | show_legend | boolean | Whether or not to display the legend on this widget. | | Option 19 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 19 | title | string | Title of the widget. | | Option 19 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 19 | title_size | string | Size of the title. | | Option 19 | type [*required*] | enum | Type of the list stream widget. Allowed enum values: `list_stream` | | definition | Option 20 | object | The Log Stream displays a log flow matching the defined query. | | Option 20 | columns | [string] | Which columns to display on the widget. | | Option 20 | description | string | The description of the widget. | | Option 20 | indexes | [string] | An array of index names to query in the stream. Use [] to query all indexes at once. | | Option 20 | logset | string | **DEPRECATED**: ID of the log set to use. | | Option 20 | message_display | enum | Amount of log lines to display Allowed enum values: `inline,expanded-md,expanded-lg` | | Option 20 | query | string | Query to filter the log stream with. | | Option 20 | show_date_column | boolean | Whether to show the date column or not | | Option 20 | show_message_column | boolean | Whether to show the message column or not | | Option 20 | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 20 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 20 | title | string | Title of the widget. | | Option 20 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 20 | title_size | string | Size of the title. | | Option 20 | type [*required*] | enum | Type of the log stream widget. Allowed enum values: `log_stream` | | definition | Option 21 | object | The monitor summary widget displays a summary view of all your Datadog monitors, or a subset based on a query. | | Option 21 | color_preference | enum | Which color to use on the widget. Allowed enum values: `background,text` | | Option 21 | count | int64 | **DEPRECATED**: The number of monitors to display. | | Option 21 | description | string | The description of the widget. | | Option 21 | display_format | enum | What to display on the widget. Allowed enum values: `counts,countsAndList,list` | | Option 21 | hide_zero_counts | boolean | Whether to show counts of 0 or not. | | Option 21 | query [*required*] | string | Query to filter the monitors with. | | Option 21 | show_last_triggered | boolean | Whether to show the time that has elapsed since the monitor/group triggered. | | Option 21 | show_priority | boolean | Whether to show the priorities column. | | Option 21 | sort | enum | Widget sorting methods. Allowed enum values: `name,group,status,tags,triggered,group,asc,group,desc,name,asc,name,desc,status,asc` | | Option 21 | start | int64 | **DEPRECATED**: The start of the list. Typically 0. | | Option 21 | summary_type | enum | Which summary type should be used. Allowed enum values: `monitors,groups,combined` | | Option 21 | title | string | Title of the widget. | | Option 21 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 21 | title_size | string | Size of the title. | | Option 21 | type [*required*] | enum | Type of the monitor summary widget. Allowed enum values: `manage_status` | | definition | Option 22 | object | The notes and links widget is similar to free text widget, but allows for more formatting options. | | Option 22 | background_color | string | Background color of the note. | | Option 22 | content [*required*] | string | Content of the note. | | Option 22 | font_size | string | Size of the text. | | Option 22 | has_padding | boolean | Whether to add padding or not. | | Option 22 | show_tick | boolean | Whether to show a tick or not. | | Option 22 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 22 | tick_edge | enum | Define how you want to align the text on the widget. Allowed enum values: `bottom,left,right,top` | | Option 22 | tick_pos | string | Where to position the tick on an edge. | | Option 22 | type [*required*] | enum | Type of the note widget. Allowed enum values: `note` | | Option 22 | vertical_align | enum | Vertical alignment. Allowed enum values: `center,top,bottom` | | definition | Option 23 | object | The powerpack widget allows you to keep similar graphs together on your timeboard. Each group has a custom header, can hold one to many graphs, and is collapsible. | | Option 23 | background_color | string | Background color of the powerpack title. | | Option 23 | banner_img | string | URL of image to display as a banner for the powerpack. | | Option 23 | powerpack_id [*required*] | string | UUID of the associated powerpack. | | Option 23 | show_title | boolean | Whether to show the title or not. | | Option 23 | template_variables | object | Powerpack template variables. | | template_variables | controlled_by_powerpack | [object] | Template variables controlled at the powerpack level. | | controlled_by_powerpack | name [*required*] | string | The name of the variable. | | controlled_by_powerpack | prefix | string | The tag prefix associated with the variable. | | controlled_by_powerpack | values [*required*] | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. | | template_variables | controlled_externally | [object] | Template variables controlled by the external resource, such as the dashboard this powerpack is on. | | controlled_externally | name [*required*] | string | The name of the variable. | | controlled_externally | prefix | string | The tag prefix associated with the variable. | | controlled_externally | values [*required*] | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. | | Option 23 | title | string | Title of the widget. | | Option 23 | type [*required*] | enum | Type of the powerpack widget. Allowed enum values: `powerpack` | | definition | Option 24 | object | The point plot displays individual data points over time. | | Option 24 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 24 | description | string | The description of the widget. | | Option 24 | legend | object | Legend configuration for the point plot widget. | | legend | type [*required*] | enum | Type of legend to show for the point plot widget. Allowed enum values: `automatic,none` | | Option 24 | markers | [object] | List of markers for the widget. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 24 | requests [*required*] | [object] | List of request configurations for the widget. | | requests | limit | int64 | Maximum number of data points to return. | | requests | projection [*required*] | object | Projection configuration for the point plot widget. | | projection | dimensions [*required*] | [object] | List of dimension mappings for the projection. | | dimensions | alias | string | Alias for the column. | | dimensions | column [*required*] | string | Source column name from the dataset. | | dimensions | dimension [*required*] | enum | Dimension of the point plot. Allowed enum values: `group,time,y,radius` | | projection | extra_columns | [string] | Additional columns to include in the projection. | | projection | type [*required*] | enum | Type of the projection. Allowed enum values: `point_plot` | | requests | query [*required*] | object | Query configuration for a data projection request. | | query | data_source [*required*] | string | Data source for the query. | | query | indexes | [string] | List of indexes to query. | | query | query_string [*required*] | string | The query string to filter events. | | query | storage | string | Storage location for the query. | | requests | request_type [*required*] | enum | Type of a data projection request. Allowed enum values: `data_projection` | | Option 24 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 24 | title | string | Title of the widget. | | Option 24 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 24 | title_size | string | Size of the title. | | Option 24 | type [*required*] | enum | Type of the point plot widget. Allowed enum values: `point_plot` | | Option 24 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 25 | object | Query values display the current value of a given metric, APM, or log query. | | Option 25 | autoscale | boolean | Whether to use auto-scaling or not. | | Option 25 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 25 | custom_unit | string | Display a unit of your choice on the widget. | | Option 25 | description | string | The description of the widget. | | Option 25 | precision | int64 | Number of decimals to show. If not defined, the widget uses the raw value. | | Option 25 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | comparison | object | Displays a change indicator showing a delta against a historical baseline. | | comparison | directionality | enum | Which direction of change is considered an improvement, determining the indicator color. Allowed enum values: `increase_better,decrease_better,neutral` | | comparison | duration [*required*] | object | The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds. | | duration | custom_timeframe | object | Required when `type` is `custom_timeframe`. Fixed time range to compare against. | | custom_timeframe | from [*required*] | int64 | Start time in milliseconds since epoch. | | custom_timeframe | to [*required*] | int64 | End time in milliseconds since epoch. | | duration | type [*required*] | enum | The comparison window type. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | comparison | type | enum | How the delta is expressed: `absolute` (raw difference), `relative` (percentage), or `both`. Allowed enum values: `absolute,relative,both` | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 25 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 25 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 25 | timeseries_background | object | Set a timeseries on the widget background. | | timeseries_background | type [*required*] | enum | Timeseries is made using an area or bars. Allowed enum values: `bars,area` | | timeseries_background | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 25 | title | string | Title of your widget. | | Option 25 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 25 | title_size | string | Size of the title. | | Option 25 | type [*required*] | enum | Type of the query value widget. Allowed enum values: `query_value` | | definition | Option 26 | object | The retention curve widget visualizes user retention rates over time. | | Option 26 | description | string | The description of the widget. | | Option 26 | requests [*required*] | [object] | List of Retention Curve widget requests. | | requests | query [*required*] | object | Retention query definition. | | query | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | query | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | query | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | query | name | string | Name of the query. | | query | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | request_type [*required*] | enum | Request type for retention curve widget. Allowed enum values: `retention_curve` | | requests | style | object | Style configuration for retention curve. | | style | palette | string | Color palette for the retention curve. | | Option 26 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 26 | title | string | Title of your widget. | | Option 26 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 26 | title_size | string | Size of the title. | | Option 26 | type [*required*] | enum | Type of the Retention Curve widget. Allowed enum values: `retention_curve` | | definition | Option 27 | object | Run workflow is widget that allows you to run a workflow from a dashboard. | | Option 27 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 27 | description | string | The description of the widget. | | Option 27 | inputs | [object] | Array of workflow inputs to map to dashboard template variables. | | inputs | name [*required*] | string | Name of the workflow input. | | inputs | value [*required*] | string | Dashboard template variable. Can be suffixed with '.value' or '.key'. | | Option 27 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 27 | title | string | Title of your widget. | | Option 27 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 27 | title_size | string | Size of the title. | | Option 27 | type [*required*] | enum | Type of the run workflow widget. Allowed enum values: `run_workflow` | | Option 27 | workflow_id [*required*] | string | Workflow id. | | definition | Option 28 | object | Use the SLO List widget to track your SLOs (Service Level Objectives) on dashboards. | | Option 28 | description | string | The description of the widget. | | Option 28 | requests [*required*] | [object] | Array of one request object to display in the widget. | | requests | query [*required*] | object | Updated SLO List widget. | | query | limit | int64 | Maximum number of results to display in the table. | | query | query_string [*required*] | string | Widget query. | | query | sort | [object] | Options for sorting results. | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | request_type [*required*] | enum | Widget request type. Allowed enum values: `slo_list` | | Option 28 | title | string | Title of the widget. | | Option 28 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 28 | title_size | string | Size of the title. | | Option 28 | type [*required*] | enum | Type of the SLO List widget. Allowed enum values: `slo_list` | | definition | Option 29 | object | Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on dashboards. | | Option 29 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 29 | description | string | The description of the widget. | | Option 29 | global_time_target | string | Defined global time target. | | Option 29 | show_error_budget | boolean | Defined error budget. | | Option 29 | slo_id | string | ID of the SLO displayed. | | Option 29 | time_windows | [string] | Times being monitored. | | Option 29 | title | string | Title of the widget. | | Option 29 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 29 | title_size | string | Size of the title. | | Option 29 | type [*required*] | enum | Type of the SLO widget. Allowed enum values: `slo` | | Option 29 | view_mode | enum | Define how you want the SLO to be displayed. Allowed enum values: `overall,component,both` | | Option 29 | view_type [*required*] | string | Type of view displayed by the widget. | | definition | Option 30 | object | The scatter plot visualization allows you to graph a chosen scope over two different metrics with their respective aggregation. | | Option 30 | color_by_groups | [string] | List of groups used for colors. | | Option 30 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 30 | description | string | The description of the widget. | | Option 30 | requests [*required*] | object | Widget definition. | | requests | table | object | Scatterplot request containing formulas and functions. | | table | formulas | [object] | List of Scatterplot formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Dimension of the Scatterplot. Allowed enum values: `x,y,radius,color` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | table | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | table | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | x | object | Updated scatter plot. | | x | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | x | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | x | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | q | string | Query definition. | | x | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | y | object | Updated scatter plot. | | y | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | y | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | y | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | q | string | Query definition. | | y | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 30 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 30 | title | string | Title of your widget. | | Option 30 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 30 | title_size | string | Size of the title. | | Option 30 | type [*required*] | enum | Type of the scatter plot widget. Allowed enum values: `scatterplot` | | Option 30 | xaxis | object | Axis controls for the widget. | | xaxis | include_zero | boolean | Set to `true` to include zero. | | xaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | xaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | xaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 30 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 31 | object | The Sankey diagram visualizes the flow of data between categories, stages or sets of values. | | Option 31 | requests [*required*] | [ ] | List of Sankey widget requests. | | requests | Option 1 | object | Sankey widget request for Product Analytics or RUM data source. | | Option 1 | query [*required*] | object | Query configuration for Product Analytics or RUM Sankey widget. | | query | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | query | data_source [*required*] | enum | Product Analytics or RUM data source type. Allowed enum values: `rum,product_analytics` | | query | entries_per_step | int64 | Entries per step. | | query | join_keys | object | Join keys. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | query | mode [*required*] | enum | Sankey mode for Product Analytics or RUM queries. Allowed enum values: `source,target` | | query | number_of_steps | int64 | Number of steps. | | query | occurrences | object | Filter applied to occurrence counts when building a Product Analytics audience. | | occurrences | operator | string | The comparison operator used for the occurrence filter (for example: `gt`, `lt`, `eq`). | | occurrences | value | string | The threshold value to compare occurrence counts against. | | query | query_string [*required*] | string | RUM event search query used to filter views or actions. | | query | source | string | Source. | | query | subquery_id | string | Subquery ID. | | query | target | string | Target. | | Option 1 | request_type [*required*] | enum | Type of the Sankey widget. Allowed enum values: `sankey` | | requests | Option 2 | object | Sankey widget request for network data source. | | Option 2 | query [*required*] | object | Query configuration for Sankey network widget. | | query | compute | object | Compute aggregation for network queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | string | Metric to aggregate. | | query | data_source [*required*] | enum | Network data source type. Allowed enum values: `network_device_flows,network` | | query | group_by [*required*] | [string] | Fields to group by. | | query | limit [*required*] | int64 | Maximum number of results. | | query | mode | enum | Sankey mode for network queries. Allowed enum values: `target` | | query | query_string [*required*] | string | Query string for filtering network data. | | query | should_exclude_missing | boolean | Whether to exclude missing values. | | query | sort | object | Sort configuration for network queries. | | sort | field | string | Field to sort by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | request_type [*required*] | enum | Type of request for network Sankey widget. Allowed enum values: `netflow_sankey` | | Option 31 | show_other_links | boolean | Whether to show links for "other" category. | | Option 31 | sort_nodes | boolean | Whether to sort nodes in the Sankey diagram. | | Option 31 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 31 | title | string | Title of your widget. | | Option 31 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 31 | title_size | string | Size of the title. | | Option 31 | type [*required*] | enum | Type of the Sankey widget. Allowed enum values: `sankey` | | definition | Option 32 | object | This widget displays a map of a service to all of the services that call it, and all of the services that it calls. | | Option 32 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 32 | description | string | The description of the widget. | | Option 32 | filters [*required*] | [string] | Your environment and primary tag (or * if enabled for your account). | | Option 32 | service [*required*] | string | The ID of the service you want to map. | | Option 32 | title | string | The title of your widget. | | Option 32 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 32 | title_size | string | Size of the title. | | Option 32 | type [*required*] | enum | Type of the service map widget. Allowed enum values: `servicemap` | | definition | Option 33 | object | The service summary displays the graphs of a chosen service in your dashboard. | | Option 33 | description | string | The description of the widget. | | Option 33 | display_format | enum | Number of columns to display. Allowed enum values: `one_column,two_column,three_column` | | Option 33 | env [*required*] | string | APM environment. | | Option 33 | service [*required*] | string | APM service. | | Option 33 | show_breakdown | boolean | Whether to show the latency breakdown or not. | | Option 33 | show_distribution | boolean | Whether to show the latency distribution or not. | | Option 33 | show_errors | boolean | Whether to show the error metrics or not. | | Option 33 | show_hits | boolean | Whether to show the hits metrics or not. | | Option 33 | show_latency | boolean | Whether to show the latency metrics or not. | | Option 33 | show_resource_list | boolean | Whether to show the resource list or not. | | Option 33 | size_format | enum | Size of the widget. Allowed enum values: `small,medium,large` | | Option 33 | span_name [*required*] | string | APM span name. | | Option 33 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 33 | title | string | Title of the widget. | | Option 33 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 33 | title_size | string | Size of the title. | | Option 33 | type [*required*] | enum | Type of the service summary widget. Allowed enum values: `trace_service` | | definition | Option 34 | object | The split graph widget allows you to create repeating units of a graph - one for each value in a group (for example: one per service) | | Option 34 | has_uniform_y_axes | boolean | Normalize y axes across graphs | | Option 34 | size [*required*] | enum | Size of the individual graphs in the split. Allowed enum values: `xs,sm,md,lg` | | Option 34 | source_widget_definition [*required*] | | The original widget we are splitting on. | | source_widget_definition | Option 1 | object | The bar chart visualization displays categorical data using vertical bars, allowing you to compare values across different groups. | | Option 1 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 1 | description | string | The description of the widget. | | Option 1 | requests [*required*] | [object] | List of bar chart widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 1 | style | object | Style customization for a bar chart widget. | | style | display | | Bar chart widget display options. | | display | Option 1 | object | Bar chart widget stacked display options. | | Option 1 | legend | enum | Bar chart widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Bar chart widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Bar chart widget flat display. | | Option 2 | type [*required*] | enum | Bar chart widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Bar chart widget scaling definition. Allowed enum values: `absolute,relative` | | Option 1 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 1 | title | string | Title of your widget. | | Option 1 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 1 | title_size | string | Size of the title. | | Option 1 | type [*required*] | enum | Type of the bar chart widget. Allowed enum values: `bar_chart` | | source_widget_definition | Option 2 | object | The Change graph shows you the change in a value over the time period chosen. | | Option 2 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 2 | description | string | The description of the widget. | | Option 2 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | change_type | enum | Show the absolute or the relative change. Allowed enum values: `absolute,relative` | | requests | compare_to | enum | Timeframe used for the change comparison. Allowed enum values: `hour_before,day_before,week_before,month_before` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | increase_good | boolean | Whether to show increase as good. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order_by | enum | What to order by. Allowed enum values: `change,name,present,past` | | requests | order_dir | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | show_present | boolean | Whether to show the present value. | | Option 2 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 2 | title | string | Title of the widget. | | Option 2 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title_size | string | Size of the title. | | Option 2 | type [*required*] | enum | Type of the change widget. Allowed enum values: `change` | | source_widget_definition | Option 3 | object | This visualization displays a series of values by country on a world map. | | Option 3 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 3 | description | string | The description of the widget. | | Option 3 | requests [*required*] | [object] | Array of request objects to display in the widget. May include an optional request for the region layer and/or an optional request for the points layer. Region layer requests must contain a `group-by` tag whose value is a country ISO code. See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) for information about building the `REQUEST_SCHEMA`. | | requests | columns | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | conditional_formats | [object] | Threshold (numeric) conditional formatting rules may be used by a regions layer. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | query | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | The style to apply to the request for points layer. | | style | color_by | string | The category to color the points by. | | requests | text_formats | [object] | Text formatting rules may be used by a points layer. | | text_formats | custom_bg_color | string | Hex representation of the custom background color. Used with custom background palette option. | | text_formats | custom_fg_color | string | Hex representation of the custom text color. Used with custom text palette option. | | text_formats | match [*required*] | object | Match rule for the table widget text format. | | match | type [*required*] | enum | Match or compare option. Allowed enum values: `is,is_not,contains,does_not_contain,starts_with,ends_with` | | match | value [*required*] | string | Table Widget Match String. | | text_formats | palette | enum | Color-on-color palette to highlight replaced text. Allowed enum values: `white_on_red,white_on_yellow,white_on_green,black_on_light_red,black_on_light_yellow,black_on_light_green,red_on_white,yellow_on_white,green_on_white,custom_bg` | | text_formats | replace | | Replace rule for the table widget text format. | | replace | Option 1 | object | Match All definition. | | Option 1 | type [*required*] | enum | Table widget text format replace all type. Allowed enum values: `all` | | Option 1 | with [*required*] | string | Replace All type. | | replace | Option 2 | object | Match Sub-string definition. | | Option 2 | substring [*required*] | string | Text that will be replaced. | | Option 2 | type [*required*] | enum | Table widget text format replace sub-string type. Allowed enum values: `substring` | | Option 2 | with [*required*] | string | Text that will replace original sub-string. | | Option 3 | style [*required*] | object | The style to apply to the widget. | | style | palette [*required*] | string | The color palette to apply to the widget. | | style | palette_flip [*required*] | boolean | Whether to flip the palette tones. | | Option 3 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 3 | title | string | The title of your widget. | | Option 3 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 3 | title_size | string | The size of the title. | | Option 3 | type [*required*] | enum | Type of the geomap widget. Allowed enum values: `geomap` | | Option 3 | view [*required*] | object | The view of the world that the map should render. | | view | focus [*required*] | string | The 2-letter ISO code of a country to focus the map on, or `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`). | | source_widget_definition | Option 4 | object | Query values display the current value of a given metric, APM, or log query. | | Option 4 | autoscale | boolean | Whether to use auto-scaling or not. | | Option 4 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 4 | custom_unit | string | Display a unit of your choice on the widget. | | Option 4 | description | string | The description of the widget. | | Option 4 | precision | int64 | Number of decimals to show. If not defined, the widget uses the raw value. | | Option 4 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | comparison | object | Displays a change indicator showing a delta against a historical baseline. | | comparison | directionality | enum | Which direction of change is considered an improvement, determining the indicator color. Allowed enum values: `increase_better,decrease_better,neutral` | | comparison | duration [*required*] | object | The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds. | | duration | custom_timeframe | object | Required when `type` is `custom_timeframe`. Fixed time range to compare against. | | custom_timeframe | from [*required*] | int64 | Start time in milliseconds since epoch. | | custom_timeframe | to [*required*] | int64 | End time in milliseconds since epoch. | | duration | type [*required*] | enum | The comparison window type. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | comparison | type | enum | How the delta is expressed: `absolute` (raw difference), `relative` (percentage), or `both`. Allowed enum values: `absolute,relative,both` | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 4 | timeseries_background | object | Set a timeseries on the widget background. | | timeseries_background | type [*required*] | enum | Timeseries is made using an area or bars. Allowed enum values: `bars,area` | | timeseries_background | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 4 | title | string | Title of your widget. | | Option 4 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | title_size | string | Size of the title. | | Option 4 | type [*required*] | enum | Type of the query value widget. Allowed enum values: `query_value` | | source_widget_definition | Option 5 | object | The scatter plot visualization allows you to graph a chosen scope over two different metrics with their respective aggregation. | | Option 5 | color_by_groups | [string] | List of groups used for colors. | | Option 5 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 5 | description | string | The description of the widget. | | Option 5 | requests [*required*] | object | Widget definition. | | requests | table | object | Scatterplot request containing formulas and functions. | | table | formulas | [object] | List of Scatterplot formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Dimension of the Scatterplot. Allowed enum values: `x,y,radius,color` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | table | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | group_by | target | object | Target for user journey search. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | search | join_keys | object | Join keys for user journey queries. | | search | node_objects [*required*] | object | Node objects mapping. | | search | step_aliases | object | Step aliases mapping. | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | search | filters | object | Filters for retention queries. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | table | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | x | object | Updated scatter plot. | | x | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | x | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | x | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | q | string | Query definition. | | x | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | y | object | Updated scatter plot. | | y | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | y | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | y | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | q | string | Query definition. | | y | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 5 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 5 | title | string | Title of your widget. | | Option 5 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 5 | title_size | string | Size of the title. | | Option 5 | type [*required*] | enum | Type of the scatter plot widget. Allowed enum values: `scatterplot` | | Option 5 | xaxis | object | Axis controls for the widget. | | xaxis | include_zero | boolean | Set to `true` to include zero. | | xaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | xaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | xaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 5 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | source_widget_definition | Option 6 | object | Sunbursts are spot on to highlight how groups contribute to the total of a query. | | Option 6 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 6 | description | string | The description of the widget. | | Option 6 | hide_total | boolean | Show the total value in this widget. | | Option 6 | legend | | Configuration of the legend. | | legend | Option 1 | object | Configuration of table-based legend. | | Option 1 | type [*required*] | enum | Whether or not to show a table legend. Allowed enum values: `table,none` | | legend | Option 2 | object | Configuration of inline or automatic legends. | | Option 2 | hide_percent | boolean | Whether to hide the percentages of the groups. | | Option 2 | hide_value | boolean | Whether to hide the values of the groups. | | Option 2 | type [*required*] | enum | Whether to show the legend inline or let it be automatically generated. Allowed enum values: `inline,automatic` | | Option 6 | requests [*required*] | [object] | List of sunburst widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 6 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 6 | title | string | Title of your widget. | | Option 6 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 6 | title_size | string | Size of the title. | | Option 6 | type [*required*] | enum | Type of the Sunburst widget. Allowed enum values: `sunburst` | | source_widget_definition | Option 7 | object | The table visualization is available on dashboards. It displays columns of metrics grouped by tag key. | | Option 7 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 7 | description | string | The description of the widget. | | Option 7 | has_search_bar | enum | Controls the display of the search bar. Allowed enum values: `always,never,auto` | | Option 7 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | alias | string | The column name (defaults to the metric name). | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | cell_display_mode | [string] | A list of display modes for each table cell. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | limit | int64 | For metric queries, the number of lines to show in the table. Only one request should have this property. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | text_formats | [array] | List of text formats for columns produced by tags. | | Option 7 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 7 | title | string | Title of your widget. | | Option 7 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 7 | title_size | string | Size of the title. | | Option 7 | type [*required*] | enum | Type of the table widget. Allowed enum values: `query_table` | | source_widget_definition | Option 8 | object | The timeseries visualization allows you to display the evolution of one or more metrics, log events, or Indexed Spans over time. | | Option 8 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 8 | description | string | The description of the widget. | | Option 8 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 8 | legend_columns | [string] | Columns displayed in the legend. | | Option 8 | legend_layout | enum | Layout of the legend. Allowed enum values: `auto,horizontal,vertical` | | Option 8 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 8 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 8 | requests [*required*] | [object] | List of timeseries widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 8 | right_yaxis | object | Axis controls for the widget. | | right_yaxis | include_zero | boolean | Set to `true` to include zero. | | right_yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | right_yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 8 | show_legend | boolean | (screenboard only) Show the legend for this widget. | | Option 8 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 8 | title | string | Title of your widget. | | Option 8 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 8 | title_size | string | Size of the title. | | Option 8 | type [*required*] | enum | Type of the timeseries widget. Allowed enum values: `timeseries` | | Option 8 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | source_widget_definition | Option 9 | object | The top list visualization enables you to display a list of Tag value like hostname or service with the most or least of any metric value, such as highest consumers of CPU, hosts with the least disk space, etc. | | Option 9 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 9 | description | string | The description of the widget. | | Option 9 | requests [*required*] | [object] | List of top list widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 9 | style | object | Style customization for a top list widget. | | style | display | | Top list widget display options. | | display | Option 1 | object | Top list widget stacked display options. | | Option 1 | legend | enum | Top list widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Top list widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Top list widget flat display. | | Option 2 | type [*required*] | enum | Top list widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Top list widget scaling definition. Allowed enum values: `absolute,relative` | | Option 9 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 9 | title | string | Title of your widget. | | Option 9 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 9 | title_size | string | Size of the title. | | Option 9 | type [*required*] | enum | Type of the top list widget. Allowed enum values: `toplist` | | source_widget_definition | Option 10 | object | The treemap visualization enables you to display hierarchical and nested data. It is well suited for queries that describe part-whole relationships, such as resource usage by availability zone, data center, or team. | | Option 10 | color_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine color in the widget. Allowed enum values: `user` | | Option 10 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 10 | description | string | The description of the widget. | | Option 10 | group_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to group elements in the widget. Allowed enum values: `user,family,process` | | Option 10 | requests [*required*] | [object] | List of treemap widget requests. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 10 | size_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine size in the widget. Allowed enum values: `pct_cpu,pct_mem` | | Option 10 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 10 | title | string | Title of your widget. | | Option 10 | type [*required*] | enum | Type of the treemap widget. Allowed enum values: `treemap` | | Option 34 | split_config [*required*] | object | Encapsulates all user choices about how to split a graph. | | split_config | limit [*required*] | int64 | Maximum number of graphs to display in the widget. | | split_config | sort [*required*] | object | Controls the order in which graphs appear in the split. | | sort | compute | object | Defines the metric and aggregation used as the sort value. | | compute | aggregation [*required*] | string | How to aggregate the sort metric for the purposes of ordering. | | compute | metric [*required*] | string | The metric to use for sorting graphs. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | split_config | split_dimensions [*required*] | [object] | The dimension(s) on which to split the graph | | split_dimensions | one_graph_per [*required*] | string | The system interprets this attribute differently depending on the data source of the query being split. For metrics, it's a tag. For the events platform, it's an attribute or tag. | | split_config | static_splits | [array] | Manual selection of tags making split graph widget static | | Option 34 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 34 | title | string | Title of your widget. | | Option 34 | type [*required*] | enum | Type of the split graph widget Allowed enum values: `split_group` | | definition | Option 35 | object | Sunbursts are spot on to highlight how groups contribute to the total of a query. | | Option 35 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 35 | description | string | The description of the widget. | | Option 35 | hide_total | boolean | Show the total value in this widget. | | Option 35 | legend | | Configuration of the legend. | | legend | Option 1 | object | Configuration of table-based legend. | | Option 1 | type [*required*] | enum | Whether or not to show a table legend. Allowed enum values: `table,none` | | legend | Option 2 | object | Configuration of inline or automatic legends. | | Option 2 | hide_percent | boolean | Whether to hide the percentages of the groups. | | Option 2 | hide_value | boolean | Whether to hide the values of the groups. | | Option 2 | type [*required*] | enum | Whether to show the legend inline or let it be automatically generated. Allowed enum values: `inline,automatic` | | Option 35 | requests [*required*] | [object] | List of sunburst widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 35 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 35 | title | string | Title of your widget. | | Option 35 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 35 | title_size | string | Size of the title. | | Option 35 | type [*required*] | enum | Type of the Sunburst widget. Allowed enum values: `sunburst` | | definition | Option 36 | object | The table visualization is available on dashboards. It displays columns of metrics grouped by tag key. | | Option 36 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 36 | description | string | The description of the widget. | | Option 36 | has_search_bar | enum | Controls the display of the search bar. Allowed enum values: `always,never,auto` | | Option 36 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | alias | string | The column name (defaults to the metric name). | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | cell_display_mode | [string] | A list of display modes for each table cell. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | limit | int64 | For metric queries, the number of lines to show in the table. Only one request should have this property. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | text_formats | [array] | List of text formats for columns produced by tags. | | Option 36 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 36 | title | string | Title of your widget. | | Option 36 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 36 | title_size | string | Size of the title. | | Option 36 | type [*required*] | enum | Type of the table widget. Allowed enum values: `query_table` | | definition | Option 37 | object | The timeseries visualization allows you to display the evolution of one or more metrics, log events, or Indexed Spans over time. | | Option 37 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 37 | description | string | The description of the widget. | | Option 37 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 37 | legend_columns | [string] | Columns displayed in the legend. | | Option 37 | legend_layout | enum | Layout of the legend. Allowed enum values: `auto,horizontal,vertical` | | Option 37 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 37 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 37 | requests [*required*] | [object] | List of timeseries widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 37 | right_yaxis | object | Axis controls for the widget. | | right_yaxis | include_zero | boolean | Set to `true` to include zero. | | right_yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | right_yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 37 | show_legend | boolean | (screenboard only) Show the legend for this widget. | | Option 37 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 37 | title | string | Title of your widget. | | Option 37 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 37 | title_size | string | Size of the title. | | Option 37 | type [*required*] | enum | Type of the timeseries widget. Allowed enum values: `timeseries` | | Option 37 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 38 | object | The top list visualization enables you to display a list of Tag value like hostname or service with the most or least of any metric value, such as highest consumers of CPU, hosts with the least disk space, etc. | | Option 38 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 38 | description | string | The description of the widget. | | Option 38 | requests [*required*] | [object] | List of top list widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 38 | style | object | Style customization for a top list widget. | | style | display | | Top list widget display options. | | display | Option 1 | object | Top list widget stacked display options. | | Option 1 | legend | enum | Top list widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Top list widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Top list widget flat display. | | Option 2 | type [*required*] | enum | Top list widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Top list widget scaling definition. Allowed enum values: `absolute,relative` | | Option 38 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 38 | title | string | Title of your widget. | | Option 38 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 38 | title_size | string | Size of the title. | | Option 38 | type [*required*] | enum | Type of the top list widget. Allowed enum values: `toplist` | | definition | Option 39 | object | This widget displays a topology of nodes and edges for different data sources. It replaces the service map widget. | | Option 39 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 39 | description | string | The description of the widget. | | Option 39 | requests [*required*] | [object] | One or more Topology requests. | | requests | query | object | Query to service-based topology data sources like the service map or data streams. | | query | data_source | enum | Name of the data source Allowed enum values: `data_streams,service_map` | | query | filters | [string] | Your environment and primary tag (or * if enabled for your account). | | query | service | string | Name of the service | | requests | request_type | enum | Widget request type. Allowed enum values: `topology` | | Option 39 | title | string | Title of your widget. | | Option 39 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 39 | title_size | string | Size of the title. | | Option 39 | type [*required*] | enum | Type of the topology map widget. Allowed enum values: `topology_map` | | definition | Option 40 | object | The treemap visualization enables you to display hierarchical and nested data. It is well suited for queries that describe part-whole relationships, such as resource usage by availability zone, data center, or team. | | Option 40 | color_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine color in the widget. Allowed enum values: `user` | | Option 40 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 40 | description | string | The description of the widget. | | Option 40 | group_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to group elements in the widget. Allowed enum values: `user,family,process` | | Option 40 | requests [*required*] | [object] | List of treemap widget requests. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 40 | size_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine size in the widget. Allowed enum values: `pct_cpu,pct_mem` | | Option 40 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 40 | title | string | Title of your widget. | | Option 40 | type [*required*] | enum | Type of the treemap widget. Allowed enum values: `treemap` | | definition | Option 41 | object | Custom visualization widget using Vega or Vega-Lite specifications. Combines standard Datadog data requests with a Vega or Vega-Lite JSON specification for flexible, custom visualizations. | | Option 41 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 41 | requests [*required*] | [ ] | List of data requests for the wildcard widget. | | requests | Option 1 | object | An updated treemap widget. | | Option 1 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 1 | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | Option 1 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 1 | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | Option 1 | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | Option 1 | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | requests | Option 2 | object | Updated timeseries widget. | | Option 2 | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | Option 2 | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 2 | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | Option 2 | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | Option 2 | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | Option 2 | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | Option 2 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 2 | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | Option 2 | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | requests | Option 3 | object | Updated list stream widget. | | Option 3 | columns [*required*] | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | Option 3 | query [*required*] | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | Option 3 | response_format [*required*] | enum | Widget response format. Allowed enum values: `event_list` | | requests | Option 4 | object | Updated distribution widget. | | Option 4 | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | Option 4 | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 4 | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | Option 4 | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | Option 4 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 4 | query | | Query definition for Distribution Widget Histogram Request | | query | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | query | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | query | Option 3 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 3 | env [*required*] | string | APM environment. | | Option 3 | group_by | [string] | Array of fields to group results by. | | Option 3 | name [*required*] | string | Name of this query to use in formulas. | | Option 3 | operation_name | string | Name of operation on service. | | Option 3 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 3 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 3 | resource_name | string | APM resource name. | | Option 3 | service [*required*] | string | APM service name. | | Option 3 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | query | Option 4 | object | A formula and functions APM metrics query. | | Option 4 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 4 | group_by | [string] | Optional fields to group the query results by. | | Option 4 | name [*required*] | string | Name of this query to use in formulas. | | Option 4 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 4 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 4 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 4 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 4 | resource_hash | string | The hash of a specific resource to filter by. | | Option 4 | resource_name | string | The full name of a specific resource to filter by. | | Option 4 | service | string | APM service name. | | Option 4 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 4 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | Option 4 | request_type | enum | Distribution of point values for distribution metrics. Renders a histogram of raw metric data points. Allowed enum values: `histogram` | | Option 4 | response_format | enum | Distribution of aggregated grouped queries. Use `request_type` instead for distribution of point values from distribution metrics. Allowed enum values: `timeseries,scalar,event_list` | | Option 4 | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 41 | specification [*required*] | object | Vega or Vega-Lite specification for custom visualization rendering. See [https://vega.github.io/vega-lite/](https://vega.github.io/vega-lite/) for the full grammar reference. | | specification | contents [*required*] | object | The Vega or Vega-Lite JSON specification object. | | specification | type [*required*] | enum | Type of specification used by the wildcard widget. Allowed enum values: `vega,vega-lite` | | Option 41 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 41 | title | string | Title of the widget. | | Option 41 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 41 | title_size | string | Size of the title. | | Option 41 | type [*required*] | enum | Type of the wildcard widget. Allowed enum values: `wildcard` | | widgets | id | int64 | ID of the widget. | | widgets | layout | object | The layout for a widget on a `free` or **new dashboard layout** dashboard. | | layout | height [*required*] | int64 | The height of the widget. Should be a non-negative integer. | | layout | is_column_break | boolean | Whether the widget should be the first one on the second column in high density or not. **Note**: Only for the **new dashboard layout** and only one widget in the dashboard should have this property set to `true`. | | layout | width [*required*] | int64 | The width of the widget. Should be a non-negative integer. | | layout | x [*required*] | int64 | The position of the widget on the x (horizontal) axis. Should be a non-negative integer. | | layout | y [*required*] | int64 | The position of the widget on the y (vertical) axis. Should be a non-negative integer. | {% /tab %} {% tab title="Example" %} ##### ```json { "layout_type": "ordered", "title": "Example-Dashboard with list_stream widget", "description": "Updated description", "widgets": [ { "definition": { "type": "list_stream", "requests": [ { "columns": [ { "width": "auto", "field": "timestamp" } ], "query": { "data_source": "apm_issue_stream", "query_string": "" }, "response_format": "event_list" } ] } } ] } ``` ##### ```json { "layout_type": "ordered", "title": "Example-Dashboard with list_stream widget", "description": "Updated description", "tags": [ "team:foo", "team:bar" ], "widgets": [ { "definition": { "type": "list_stream", "requests": [ { "columns": [ { "width": "auto", "field": "timestamp" } ], "query": { "data_source": "apm_issue_stream", "query_string": "" }, "response_format": "event_list" } ] } } ] } ``` {% /tab %} ### Response {% tab title="200" %} OK {% tab title="Model" %} A dashboard is Datadog's tool for visually tracking, analyzing, and displaying key performance metrics, which enable you to monitor the health of your infrastructure. | Parent field | Field | Type | Description | | ------------------------- | ------------------------------------------ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | author_handle | string | Identifier of the dashboard author. | | | author_name | string | Name of the dashboard author. | | | created_at | date-time | Creation date of the dashboard. | | | description | string | Description of the dashboard. | | | id | string | ID of the dashboard. | | | is_read_only | boolean | **DEPRECATED**: Whether this dashboard is read-only. If True, only the author and admins can make changes to it. | This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies.md) instead to manage write authorization for individual dashboards. | | | layout_type [*required*] | enum | Layout type of the dashboard. Allowed enum values: `ordered,free` | | | modified_at | date-time | Modification date of the dashboard. | | | notify_list | [string] | List of handles of users to notify when changes are made to this dashboard. | | | reflow_type | enum | Reflow type for a **new dashboard layout** dashboard. Set this only when layout type is 'ordered'. If set to 'fixed', the dashboard expects all widgets to have a layout, and if it's set to 'auto', widgets should not have layouts. Allowed enum values: `auto,fixed` | | | restricted_roles | [string] | A list of role identifiers. Only the author and users associated with at least one of these roles can edit this dashboard. | | | tabs | [object] | List of tabs for organizing dashboard widgets into groups. | | tabs | id [*required*] | uuid | UUID of the tab. | | tabs | name [*required*] | string | Name of the tab. | | tabs | widget_ids [*required*] | [integer] | List of widget IDs belonging to this tab. The backend also accepts positional references in @N format (1-indexed) as a convenience for Terraform and other declarative tools. | | | tags | [string] | List of team names representing ownership of a dashboard. | | | template_variable_presets | [object] | Array of template variables saved views. | | template_variable_presets | name | string | The name of the variable. | | template_variable_presets | template_variables | [object] | List of variables. | | template_variables | name | string | The name of the variable. | | template_variables | value | string | **DEPRECATED**: (deprecated) The value of the template variable within the saved view. Cannot be used in conjunction with `values`. | | template_variables | values | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. Cannot be used in conjunction with `value`. | | | template_variables | [object] | List of template variables for this dashboard. | | template_variables | available_values | [string] | The list of values that the template variable drop-down is limited to. | | template_variables | default | string | **DEPRECATED**: (deprecated) The default value for the template variable on dashboard load. Cannot be used in conjunction with `defaults`. | | template_variables | defaults | [string] | One or many default values for template variables on load. If more than one default is specified, they will be unioned together with `OR`. Cannot be used in conjunction with `default`. | | template_variables | name [*required*] | string | The name of the variable. | | template_variables | prefix | string | The tag prefix associated with the variable. Only tags with this prefix appear in the variable drop-down. | | template_variables | type | string | The type of variable. This is to differentiate between filter variables (interpolated in query) and group by variables (interpolated into group by). | | | title [*required*] | string | Title of the dashboard. | | | url | string | The URL of the dashboard. | | | widgets [*required*] | [object] | List of widgets to display on the dashboard. | | widgets | definition [*required*] | | [Definition of the widget](https://docs.datadoghq.com/dashboards/widgets.md). | | definition | Option 1 | object | Alert graphs are timeseries graphs showing the current status of any monitor defined on your system. | | Option 1 | alert_id [*required*] | string | ID of the alert to use in the widget. | | Option 1 | description | string | The description of the widget. | | Option 1 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 1 | title | string | The title of the widget. | | Option 1 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 1 | title_size | string | Size of the title. | | Option 1 | type [*required*] | enum | Type of the alert graph widget. Allowed enum values: `alert_graph` | | Option 1 | viz_type [*required*] | enum | Whether to display the Alert Graph as a timeseries or a top list. Allowed enum values: `timeseries,toplist` | | definition | Option 2 | object | Alert values are query values showing the current value of the metric in any monitor defined on your system. | | Option 2 | alert_id [*required*] | string | ID of the alert to use in the widget. | | Option 2 | description | string | The description of the widget. | | Option 2 | precision | int64 | Number of decimal to show. If not defined, will use the raw value. | | Option 2 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title | string | Title of the widget. | | Option 2 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title_size | string | Size of value in the widget. | | Option 2 | type [*required*] | enum | Type of the alert value widget. Allowed enum values: `alert_value` | | Option 2 | unit | string | Unit to display with the value. | | definition | Option 3 | object | The bar chart visualization displays categorical data using vertical bars, allowing you to compare values across different groups. | | Option 3 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 3 | description | string | The description of the widget. | | Option 3 | requests [*required*] | [object] | List of bar chart widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 3 | style | object | Style customization for a bar chart widget. | | style | display | | Bar chart widget display options. | | display | Option 1 | object | Bar chart widget stacked display options. | | Option 1 | legend | enum | Bar chart widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Bar chart widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Bar chart widget flat display. | | Option 2 | type [*required*] | enum | Bar chart widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Bar chart widget scaling definition. Allowed enum values: `absolute,relative` | | Option 3 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 3 | title | string | Title of your widget. | | Option 3 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 3 | title_size | string | Size of the title. | | Option 3 | type [*required*] | enum | Type of the bar chart widget. Allowed enum values: `bar_chart` | | definition | Option 4 | object | The Change graph shows you the change in a value over the time period chosen. | | Option 4 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 4 | description | string | The description of the widget. | | Option 4 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | change_type | enum | Show the absolute or the relative change. Allowed enum values: `absolute,relative` | | requests | compare_to | enum | Timeframe used for the change comparison. Allowed enum values: `hour_before,day_before,week_before,month_before` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | increase_good | boolean | Whether to show increase as good. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order_by | enum | What to order by. Allowed enum values: `change,name,present,past` | | requests | order_dir | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | show_present | boolean | Whether to show the present value. | | Option 4 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 4 | title | string | Title of the widget. | | Option 4 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | title_size | string | Size of the title. | | Option 4 | type [*required*] | enum | Type of the change widget. Allowed enum values: `change` | | definition | Option 5 | object | Check status shows the current status or number of results for any check performed. | | Option 5 | check [*required*] | string | Name of the check to use in the widget. | | Option 5 | description | string | The description of the widget. | | Option 5 | group | string | Group reporting a single check. | | Option 5 | group_by | [string] | List of tag prefixes to group by in the case of a cluster check. | | Option 5 | grouping [*required*] | enum | The kind of grouping to use. Allowed enum values: `check,cluster` | | Option 5 | tags | [string] | List of tags used to filter the groups reporting a cluster check. | | Option 5 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 5 | title | string | Title of the widget. | | Option 5 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 5 | title_size | string | Size of the title. | | Option 5 | type [*required*] | enum | Type of the check status widget. Allowed enum values: `check_status` | | definition | Option 6 | object | The cohort widget visualizes user retention over time. | | Option 6 | description | string | The description of the widget. | | Option 6 | requests [*required*] | [object] | List of Cohort widget requests. | | requests | query [*required*] | object | Retention query definition. | | query | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | query | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | query | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | query | name | string | Name of the query. | | query | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | request_type [*required*] | enum | Request type for retention grid widget. Allowed enum values: `retention_grid` | | Option 6 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 6 | title | string | Title of your widget. | | Option 6 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 6 | title_size | string | Size of the title. | | Option 6 | type [*required*] | enum | Type of the Cohort widget. Allowed enum values: `cohort` | | definition | Option 7 | object | The Distribution visualization is another way of showing metrics aggregated across one or several tags, such as hosts. Unlike the heat map, a distribution graph's x-axis is quantity rather than time. | | Option 7 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 7 | description | string | The description of the widget. | | Option 7 | legend_size | string | **DEPRECATED**: (Deprecated) The widget legend was replaced by a tooltip and sidebar. | | Option 7 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 7 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | | Query definition for Distribution Widget Histogram Request | | query | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | query | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | query | Option 3 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 3 | env [*required*] | string | APM environment. | | Option 3 | group_by | [string] | Array of fields to group results by. | | Option 3 | name [*required*] | string | Name of this query to use in formulas. | | Option 3 | operation_name | string | Name of operation on service. | | Option 3 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 3 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 3 | resource_name | string | APM resource name. | | Option 3 | service [*required*] | string | APM service name. | | Option 3 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | query | Option 4 | object | A formula and functions APM metrics query. | | Option 4 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 4 | group_by | [string] | Optional fields to group the query results by. | | Option 4 | name [*required*] | string | Name of this query to use in formulas. | | Option 4 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 4 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 4 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 4 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 4 | resource_hash | string | The hash of a specific resource to filter by. | | Option 4 | resource_name | string | The full name of a specific resource to filter by. | | Option 4 | service | string | APM service name. | | Option 4 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 4 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | requests | request_type | enum | Distribution of point values for distribution metrics. Renders a histogram of raw metric data points. Allowed enum values: `histogram` | | requests | response_format | enum | Distribution of aggregated grouped queries. Use `request_type` instead for distribution of point values from distribution metrics. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 7 | show_legend | boolean | **DEPRECATED**: (Deprecated) The widget legend was replaced by a tooltip and sidebar. | | Option 7 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 7 | title | string | Title of the widget. | | Option 7 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 7 | title_size | string | Size of the title. | | Option 7 | type [*required*] | enum | Type of the distribution widget. Allowed enum values: `distribution` | | Option 7 | xaxis | object | X Axis controls for the distribution widget. | | xaxis | include_zero | boolean | True includes zero. | | xaxis | max | string | Specifies maximum value to show on the x-axis. It takes a number, percentile (p90 === 90th percentile), or auto for default behavior. | | xaxis | min | string | Specifies minimum value to show on the x-axis. It takes a number, percentile (p90 === 90th percentile), or auto for default behavior. | | xaxis | num_buckets | int64 | Number of value buckets to target, also known as the resolution of the value bins. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`. | | Option 7 | yaxis | object | Y Axis controls for the distribution widget. | | yaxis | include_zero | boolean | True includes zero. | | yaxis | label | string | The label of the axis to display on the graph. | | yaxis | max | string | Specifies the maximum value to show on the y-axis. It takes a number, or auto for default behavior. | | yaxis | min | string | Specifies minimum value to show on the y-axis. It takes a number, or auto for default behavior. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear` or `log`. | | definition | Option 8 | object | The event stream is a widget version of the stream of events on the Event Stream view. Only available on FREE layout dashboards. | | Option 8 | description | string | The description of the widget. | | Option 8 | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | Option 8 | query [*required*] | string | Query to filter the event stream with. | | Option 8 | tags_execution | string | The execution method for multi-value filters. Can be either and or or. | | Option 8 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 8 | title | string | Title of the widget. | | Option 8 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 8 | title_size | string | Size of the title. | | Option 8 | type [*required*] | enum | Type of the event stream widget. Allowed enum values: `event_stream` | | definition | Option 9 | object | The event timeline is a widget version of the timeline that appears at the top of the Event Stream view. Only available on FREE layout dashboards. | | Option 9 | description | string | The description of the widget. | | Option 9 | query [*required*] | string | Query to filter the event timeline with. | | Option 9 | tags_execution | string | The execution method for multi-value filters. Can be either and or or. | | Option 9 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 9 | title | string | Title of the widget. | | Option 9 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 9 | title_size | string | Size of the title. | | Option 9 | type [*required*] | enum | Type of the event timeline widget. Allowed enum values: `event_timeline` | | definition | Option 10 | object | Free text is a widget that allows you to add headings to your dashboard. Commonly used to state the overall purpose of the dashboard. | | Option 10 | background_color | string | Background color of the widget. Supported values are `white`, `blue`, `purple`, `pink`, `orange`, `yellow`, `green`, `gray`, `vivid_blue`, `vivid_purple`, `vivid_pink`, `vivid_orange`, `vivid_yellow`, `vivid_green`, and `transparent`. | | Option 10 | color | string | Color of the text. | | Option 10 | font_size | string | Size of the text. | | Option 10 | text [*required*] | string | Text to display. | | Option 10 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 10 | type [*required*] | enum | Type of the free text widget. Allowed enum values: `free_text` | | definition | Option 11 | object | The funnel visualization displays a funnel of user sessions that maps a sequence of view navigation and user interaction in your application. | | Option 11 | description | string | The description of the widget. | | Option 11 | grouped_display | enum | Display mode for grouped funnel results. Allowed enum values: `stacked,side_by_side` | | Option 11 | requests [*required*] | [object] | Request payload used to query items. | | requests | query [*required*] | object | Updated funnel widget. | | query | data_source [*required*] | enum | Source from which to query items to display in the funnel. Allowed enum values: `rum` | | query | query_string [*required*] | string | The widget query. | | query | steps [*required*] | [object] | List of funnel steps. | | steps | facet [*required*] | string | The facet of the step. | | steps | value [*required*] | string | The value of the step. | | requests | request_type [*required*] | enum | Widget request type. Allowed enum values: `funnel` | | Option 11 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 11 | title | string | The title of the widget. | | Option 11 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 11 | title_size | string | The size of the title. | | Option 11 | type [*required*] | enum | Type of funnel widget. Allowed enum values: `funnel` | | definition | Option 12 | object | The user journey funnel visualization displays conversion funnels based on user journey data from Product Analytics. | | Option 12 | description | string | The description of the widget. | | Option 12 | grouped_display | enum | Display mode for grouped funnel results. Allowed enum values: `stacked,side_by_side` | | Option 12 | requests [*required*] | [object] | Request payload used to query items. | | requests | comparison_segments | [string] | Comparison segments. | | requests | comparison_time | object | Comparison time configuration for funnel widgets. | | comparison_time | custom_timeframe | object | Custom timeframe for funnel comparison. | | custom_timeframe | from [*required*] | double | Start of the custom timeframe. | | custom_timeframe | to [*required*] | double | End of the custom timeframe. | | comparison_time | type [*required*] | enum | Type of comparison duration. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | requests | query [*required*] | object | User journey funnel query definition. | | query | compute | object | Compute configuration for user journey funnel. | | compute | aggregation [*required*] | enum | Aggregation type for user journey funnel compute. Allowed enum values: `cardinality,count` | | compute | metric [*required*] | enum | Metric for user journey funnel compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` (unique users/sessions) and `cardinality` (total users/sessions) as aggregations. Allowed enum values: `__dd.conversion,__dd.conversion_rate` | | query | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for user journey funnel group by. | | sort | aggregation [*required*] | string | Aggregation type. | | sort | metric | string | Metric to sort by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | query | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | query | subquery_id | string | Subquery ID. | | requests | request_type [*required*] | enum | Request type for user journey funnel widget. Allowed enum values: `user_journey_funnel` | | Option 12 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 12 | title | string | The title of the widget. | | Option 12 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 12 | title_size | string | The size of the title. | | Option 12 | type [*required*] | enum | Type of funnel widget. Allowed enum values: `funnel` | | definition | Option 13 | object | This visualization displays a series of values by country on a world map. | | Option 13 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 13 | description | string | The description of the widget. | | Option 13 | requests [*required*] | [object] | Array of request objects to display in the widget. May include an optional request for the region layer and/or an optional request for the points layer. Region layer requests must contain a `group-by` tag whose value is a country ISO code. See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) for information about building the `REQUEST_SCHEMA`. | | requests | columns | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | conditional_formats | [object] | Threshold (numeric) conditional formatting rules may be used by a regions layer. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | The style to apply to the request for points layer. | | style | color_by | string | The category to color the points by. | | requests | text_formats | [object] | Text formatting rules may be used by a points layer. | | text_formats | custom_bg_color | string | Hex representation of the custom background color. Used with custom background palette option. | | text_formats | custom_fg_color | string | Hex representation of the custom text color. Used with custom text palette option. | | text_formats | match [*required*] | object | Match rule for the table widget text format. | | match | type [*required*] | enum | Match or compare option. Allowed enum values: `is,is_not,contains,does_not_contain,starts_with,ends_with` | | match | value [*required*] | string | Table Widget Match String. | | text_formats | palette | enum | Color-on-color palette to highlight replaced text. Allowed enum values: `white_on_red,white_on_yellow,white_on_green,black_on_light_red,black_on_light_yellow,black_on_light_green,red_on_white,yellow_on_white,green_on_white,custom_bg` | | text_formats | replace | | Replace rule for the table widget text format. | | replace | Option 1 | object | Match All definition. | | Option 1 | type [*required*] | enum | Table widget text format replace all type. Allowed enum values: `all` | | Option 1 | with [*required*] | string | Replace All type. | | replace | Option 2 | object | Match Sub-string definition. | | Option 2 | substring [*required*] | string | Text that will be replaced. | | Option 2 | type [*required*] | enum | Table widget text format replace sub-string type. Allowed enum values: `substring` | | Option 2 | with [*required*] | string | Text that will replace original sub-string. | | Option 13 | style [*required*] | object | The style to apply to the widget. | | style | palette [*required*] | string | The color palette to apply to the widget. | | style | palette_flip [*required*] | boolean | Whether to flip the palette tones. | | Option 13 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 13 | title | string | The title of your widget. | | Option 13 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 13 | title_size | string | The size of the title. | | Option 13 | type [*required*] | enum | Type of the geomap widget. Allowed enum values: `geomap` | | Option 13 | view [*required*] | object | The view of the world that the map should render. | | view | focus [*required*] | string | The 2-letter ISO code of a country to focus the map on, or `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`). | | definition | Option 14 | object | The group widget allows you to keep similar graphs together on your dashboard. Each group has a custom header, can hold one to many graphs, and is collapsible. | | Option 14 | background_color | string | Background color of the widget. Supported values are `white`, `blue`, `purple`, `pink`, `orange`, `yellow`, `green`, `gray`, `vivid_blue`, `vivid_purple`, `vivid_pink`, `vivid_orange`, `vivid_yellow`, `vivid_green`, and `transparent`. | | Option 14 | banner_img | string | URL of image to display as a banner for the group. | | Option 14 | layout_type [*required*] | enum | Layout type of the group. Allowed enum values: `ordered` | | Option 14 | show_title | boolean | Whether to show the title or not. | | Option 14 | title | string | Title of the widget. | | Option 14 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 14 | type [*required*] | enum | Type of the group widget. Allowed enum values: `group` | | Option 14 | widgets [*required*] | [object] | List of widget groups. | | definition | Option 15 | object | The heat map visualization shows metrics aggregated across many tags, such as hosts. The more hosts that have a particular value, the darker that square is. | | Option 15 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 15 | description | string | The description of the widget. | | Option 15 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 15 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 15 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 15 | requests [*required*] | [object] | List of widget types. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | search [*required*] | string | The query being made on the event. | | event_query | tags_execution [*required*] | string | The execution method for multi-value filters. Can be either and or or. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | query | object | A formula and functions metrics query. | | query | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | query | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | query | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | query | name [*required*] | string | Name of the query for use in formulas. | | query | query [*required*] | string | Metrics query definition. | | query | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | requests | request_type | enum | Applicable only for distribution of point values for distribution metrics. Allowed enum values: `histogram` | | requests | response_format | enum | Applicable only for distribution of aggregated grouped queries. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 15 | show_legend | boolean | Whether or not to display the legend on this widget. | | Option 15 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 15 | title | string | Title of the widget. | | Option 15 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 15 | title_size | string | Size of the title. | | Option 15 | type [*required*] | enum | Type of the heat map widget. Allowed enum values: `heatmap` | | Option 15 | xaxis | object | X Axis controls for the heat map widget. | | xaxis | num_buckets | int64 | Number of time buckets to target, also known as the resolution of the time bins. This is only applicable for distribution of points (group distributions use the roll-up modifier). | | Option 15 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 16 | object | The host map widget graphs any metric across your hosts using the same visualization available from the main Host Map page. | | Option 16 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 16 | description | string | The description of the widget. | | Option 16 | group | [string] | List of tag prefixes to group by. | | Option 16 | no_group_hosts | boolean | Whether to show the hosts that don't fit in a group. | | Option 16 | no_metric_hosts | boolean | Whether to show the hosts with no metrics. | | Option 16 | node_type | enum | Which type of node to use in the map. Allowed enum values: `host,container` | | Option 16 | notes | string | Notes on the title. | | Option 16 | requests [*required*] | object | Query definition for the host map widget. Supports two mutually exclusive formats distinguished by the presence of `request_type`: the legacy metric-based format (`fill`/`size`) and the infrastructure-backed format (`request_type`, `node_type`, `enrichments`). | | requests | child | object | Infrastructure-backed request for the host map widget. Supports entity-based visualization with metric query enrichments, tag-based filtering, flexible grouping, and hierarchical views. | | child | child | object | Optional child request for hierarchical visualization (for example, hosts containing containers). Maximum one level of nesting. | | child | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | child | enrichments [*required*] | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | unit | Option 2 | object | Custom unit. | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | group_by | target | object | Target for user journey search. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | search | join_keys | object | Join keys for user journey queries. | | search | node_objects [*required*] | object | Node objects mapping. | | search | step_aliases | object | Step aliases mapping. | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | search | filters | object | Filters for retention queries. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | child | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | child | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | child | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | child | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | child | node_type [*required*] | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | child | request_type [*required*] | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | child | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | child | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | child | enrichments [*required*] | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | child | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | child | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | child | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | child | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | child | node_type [*required*] | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | child | request_type [*required*] | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | child | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | requests | conditional_formats | [object] | List of conditional formatting rules applied to fill values. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | enrichments | [object] | Metric or event queries joined to the entity set. Each formula specifies a visual dimension. | | enrichments | formulas [*required*] | [object] | List of formulas that operate on queries, each assigned to a visual dimension. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Visual dimension driven by a formula in the infrastructure host map widget. Allowed enum values: `node,fill,size` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | enrichments | queries [*required*] | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | enrichments | response_format [*required*] | enum | Response format for the scalar formula request. Only `scalar` is supported. Allowed enum values: `scalar` | | requests | fill | object | Updated host map. | | fill | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | fill | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | q | string | Query definition. | | fill | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | fill | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | filter | string | Filter string for the entity set in tag format (for example, `env:prod`). | | requests | group_by | [object] | Defines how entities are grouped into tiles. The ordering of entries implies the grouping hierarchy. | | group_by | column [*required*] | string | Column name from the entity table (for example, `cloud_provider`, `tags`, `labels`). | | group_by | key | string | Key within the column for nested attribute types (for example, `service` within `tags`). | | requests | no_group_hosts | boolean | Whether to hide entities that have no group assignment. | | requests | no_metric_hosts | boolean | Whether to hide entities that have no enrichment data. | | requests | node_type | enum | Which type of infrastructure entity to visualize in the host map. Allowed enum values: `host,container,pod,cluster` | | requests | request_type | enum | Identifies this as an infrastructure-backed host map request. Allowed enum values: `infrastructure_hostmap` | | requests | size | object | Updated host map. | | size | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | size | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | q | string | Query definition. | | size | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | size | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Style configuration for the infrastructure host map. | | style | fill_max | double | Maximum value for the fill color scale. Omit to use automatic scaling. | | style | fill_min | double | Minimum value for the fill color scale. Omit to use automatic scaling. | | style | palette | string | Color palette name or alias. | | style | palette_flip | boolean | Whether to invert the color palette. | | Option 16 | scope | [string] | List of tags used to filter the map. | | Option 16 | style | object | The style to apply to the widget. | | style | fill_max | string | Max value to use to color the map. | | style | fill_min | string | Min value to use to color the map. | | style | palette | string | Color palette to apply to the widget. | | style | palette_flip | boolean | Whether to flip the palette tones. | | Option 16 | title | string | Title of the widget. | | Option 16 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 16 | title_size | string | Size of the title. | | Option 16 | type [*required*] | enum | Type of the host map widget. Allowed enum values: `hostmap` | | definition | Option 17 | object | The iframe widget allows you to embed a portion of any other web page on your dashboard. | | Option 17 | type [*required*] | enum | Type of the iframe widget. Allowed enum values: `iframe` | | Option 17 | url [*required*] | string | URL of the iframe. | | definition | Option 18 | object | The image widget allows you to embed an image on your dashboard. An image can be a PNG, JPG, or animated GIF. | | Option 18 | has_background | boolean | Whether to display a background or not. | | Option 18 | has_border | boolean | Whether to display a border or not. | | Option 18 | horizontal_align | enum | Horizontal alignment. Allowed enum values: `center,left,right` | | Option 18 | margin | enum | Size of the margins around the image. **Note**: `small` and `large` values are deprecated. Allowed enum values: `sm,md,lg,small,large` | | Option 18 | sizing | enum | How to size the image on the widget. The values are based on the image `object-fit` CSS properties. **Note**: `zoom`, `fit` and `center` values are deprecated. Allowed enum values: `fill,contain,cover,none,scale-down,zoom,fit,center` | | Option 18 | type [*required*] | enum | Type of the image widget. Allowed enum values: `image` | | Option 18 | url [*required*] | string | URL of the image. | | Option 18 | url_dark_theme | string | URL of the image in dark mode. | | Option 18 | vertical_align | enum | Vertical alignment. Allowed enum values: `center,top,bottom` | | definition | Option 19 | object | The list stream visualization displays a table of recent events in your application that match a search criteria using user-defined columns. | | Option 19 | description | string | The description of the widget. | | Option 19 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 19 | requests [*required*] | [object] | Request payload used to query items. | | requests | columns [*required*] | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | query [*required*] | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format [*required*] | enum | Widget response format. Allowed enum values: `event_list` | | Option 19 | show_legend | boolean | Whether or not to display the legend on this widget. | | Option 19 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 19 | title | string | Title of the widget. | | Option 19 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 19 | title_size | string | Size of the title. | | Option 19 | type [*required*] | enum | Type of the list stream widget. Allowed enum values: `list_stream` | | definition | Option 20 | object | The Log Stream displays a log flow matching the defined query. | | Option 20 | columns | [string] | Which columns to display on the widget. | | Option 20 | description | string | The description of the widget. | | Option 20 | indexes | [string] | An array of index names to query in the stream. Use [] to query all indexes at once. | | Option 20 | logset | string | **DEPRECATED**: ID of the log set to use. | | Option 20 | message_display | enum | Amount of log lines to display Allowed enum values: `inline,expanded-md,expanded-lg` | | Option 20 | query | string | Query to filter the log stream with. | | Option 20 | show_date_column | boolean | Whether to show the date column or not | | Option 20 | show_message_column | boolean | Whether to show the message column or not | | Option 20 | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 20 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 20 | title | string | Title of the widget. | | Option 20 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 20 | title_size | string | Size of the title. | | Option 20 | type [*required*] | enum | Type of the log stream widget. Allowed enum values: `log_stream` | | definition | Option 21 | object | The monitor summary widget displays a summary view of all your Datadog monitors, or a subset based on a query. | | Option 21 | color_preference | enum | Which color to use on the widget. Allowed enum values: `background,text` | | Option 21 | count | int64 | **DEPRECATED**: The number of monitors to display. | | Option 21 | description | string | The description of the widget. | | Option 21 | display_format | enum | What to display on the widget. Allowed enum values: `counts,countsAndList,list` | | Option 21 | hide_zero_counts | boolean | Whether to show counts of 0 or not. | | Option 21 | query [*required*] | string | Query to filter the monitors with. | | Option 21 | show_last_triggered | boolean | Whether to show the time that has elapsed since the monitor/group triggered. | | Option 21 | show_priority | boolean | Whether to show the priorities column. | | Option 21 | sort | enum | Widget sorting methods. Allowed enum values: `name,group,status,tags,triggered,group,asc,group,desc,name,asc,name,desc,status,asc` | | Option 21 | start | int64 | **DEPRECATED**: The start of the list. Typically 0. | | Option 21 | summary_type | enum | Which summary type should be used. Allowed enum values: `monitors,groups,combined` | | Option 21 | title | string | Title of the widget. | | Option 21 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 21 | title_size | string | Size of the title. | | Option 21 | type [*required*] | enum | Type of the monitor summary widget. Allowed enum values: `manage_status` | | definition | Option 22 | object | The notes and links widget is similar to free text widget, but allows for more formatting options. | | Option 22 | background_color | string | Background color of the note. | | Option 22 | content [*required*] | string | Content of the note. | | Option 22 | font_size | string | Size of the text. | | Option 22 | has_padding | boolean | Whether to add padding or not. | | Option 22 | show_tick | boolean | Whether to show a tick or not. | | Option 22 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 22 | tick_edge | enum | Define how you want to align the text on the widget. Allowed enum values: `bottom,left,right,top` | | Option 22 | tick_pos | string | Where to position the tick on an edge. | | Option 22 | type [*required*] | enum | Type of the note widget. Allowed enum values: `note` | | Option 22 | vertical_align | enum | Vertical alignment. Allowed enum values: `center,top,bottom` | | definition | Option 23 | object | The powerpack widget allows you to keep similar graphs together on your timeboard. Each group has a custom header, can hold one to many graphs, and is collapsible. | | Option 23 | background_color | string | Background color of the powerpack title. | | Option 23 | banner_img | string | URL of image to display as a banner for the powerpack. | | Option 23 | powerpack_id [*required*] | string | UUID of the associated powerpack. | | Option 23 | show_title | boolean | Whether to show the title or not. | | Option 23 | template_variables | object | Powerpack template variables. | | template_variables | controlled_by_powerpack | [object] | Template variables controlled at the powerpack level. | | controlled_by_powerpack | name [*required*] | string | The name of the variable. | | controlled_by_powerpack | prefix | string | The tag prefix associated with the variable. | | controlled_by_powerpack | values [*required*] | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. | | template_variables | controlled_externally | [object] | Template variables controlled by the external resource, such as the dashboard this powerpack is on. | | controlled_externally | name [*required*] | string | The name of the variable. | | controlled_externally | prefix | string | The tag prefix associated with the variable. | | controlled_externally | values [*required*] | [string] | One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. | | Option 23 | title | string | Title of the widget. | | Option 23 | type [*required*] | enum | Type of the powerpack widget. Allowed enum values: `powerpack` | | definition | Option 24 | object | The point plot displays individual data points over time. | | Option 24 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 24 | description | string | The description of the widget. | | Option 24 | legend | object | Legend configuration for the point plot widget. | | legend | type [*required*] | enum | Type of legend to show for the point plot widget. Allowed enum values: `automatic,none` | | Option 24 | markers | [object] | List of markers for the widget. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 24 | requests [*required*] | [object] | List of request configurations for the widget. | | requests | limit | int64 | Maximum number of data points to return. | | requests | projection [*required*] | object | Projection configuration for the point plot widget. | | projection | dimensions [*required*] | [object] | List of dimension mappings for the projection. | | dimensions | alias | string | Alias for the column. | | dimensions | column [*required*] | string | Source column name from the dataset. | | dimensions | dimension [*required*] | enum | Dimension of the point plot. Allowed enum values: `group,time,y,radius` | | projection | extra_columns | [string] | Additional columns to include in the projection. | | projection | type [*required*] | enum | Type of the projection. Allowed enum values: `point_plot` | | requests | query [*required*] | object | Query configuration for a data projection request. | | query | data_source [*required*] | string | Data source for the query. | | query | indexes | [string] | List of indexes to query. | | query | query_string [*required*] | string | The query string to filter events. | | query | storage | string | Storage location for the query. | | requests | request_type [*required*] | enum | Type of a data projection request. Allowed enum values: `data_projection` | | Option 24 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 24 | title | string | Title of the widget. | | Option 24 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 24 | title_size | string | Size of the title. | | Option 24 | type [*required*] | enum | Type of the point plot widget. Allowed enum values: `point_plot` | | Option 24 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 25 | object | Query values display the current value of a given metric, APM, or log query. | | Option 25 | autoscale | boolean | Whether to use auto-scaling or not. | | Option 25 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 25 | custom_unit | string | Display a unit of your choice on the widget. | | Option 25 | description | string | The description of the widget. | | Option 25 | precision | int64 | Number of decimals to show. If not defined, the widget uses the raw value. | | Option 25 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | comparison | object | Displays a change indicator showing a delta against a historical baseline. | | comparison | directionality | enum | Which direction of change is considered an improvement, determining the indicator color. Allowed enum values: `increase_better,decrease_better,neutral` | | comparison | duration [*required*] | object | The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds. | | duration | custom_timeframe | object | Required when `type` is `custom_timeframe`. Fixed time range to compare against. | | custom_timeframe | from [*required*] | int64 | Start time in milliseconds since epoch. | | custom_timeframe | to [*required*] | int64 | End time in milliseconds since epoch. | | duration | type [*required*] | enum | The comparison window type. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | comparison | type | enum | How the delta is expressed: `absolute` (raw difference), `relative` (percentage), or `both`. Allowed enum values: `absolute,relative,both` | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 25 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 25 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 25 | timeseries_background | object | Set a timeseries on the widget background. | | timeseries_background | type [*required*] | enum | Timeseries is made using an area or bars. Allowed enum values: `bars,area` | | timeseries_background | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 25 | title | string | Title of your widget. | | Option 25 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 25 | title_size | string | Size of the title. | | Option 25 | type [*required*] | enum | Type of the query value widget. Allowed enum values: `query_value` | | definition | Option 26 | object | The retention curve widget visualizes user retention rates over time. | | Option 26 | description | string | The description of the widget. | | Option 26 | requests [*required*] | [object] | List of Retention Curve widget requests. | | requests | query [*required*] | object | Retention query definition. | | query | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | query | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | query | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | query | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | query | name | string | Name of the query. | | query | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | request_type [*required*] | enum | Request type for retention curve widget. Allowed enum values: `retention_curve` | | requests | style | object | Style configuration for retention curve. | | style | palette | string | Color palette for the retention curve. | | Option 26 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 26 | title | string | Title of your widget. | | Option 26 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 26 | title_size | string | Size of the title. | | Option 26 | type [*required*] | enum | Type of the Retention Curve widget. Allowed enum values: `retention_curve` | | definition | Option 27 | object | Run workflow is widget that allows you to run a workflow from a dashboard. | | Option 27 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 27 | description | string | The description of the widget. | | Option 27 | inputs | [object] | Array of workflow inputs to map to dashboard template variables. | | inputs | name [*required*] | string | Name of the workflow input. | | inputs | value [*required*] | string | Dashboard template variable. Can be suffixed with '.value' or '.key'. | | Option 27 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 27 | title | string | Title of your widget. | | Option 27 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 27 | title_size | string | Size of the title. | | Option 27 | type [*required*] | enum | Type of the run workflow widget. Allowed enum values: `run_workflow` | | Option 27 | workflow_id [*required*] | string | Workflow id. | | definition | Option 28 | object | Use the SLO List widget to track your SLOs (Service Level Objectives) on dashboards. | | Option 28 | description | string | The description of the widget. | | Option 28 | requests [*required*] | [object] | Array of one request object to display in the widget. | | requests | query [*required*] | object | Updated SLO List widget. | | query | limit | int64 | Maximum number of results to display in the table. | | query | query_string [*required*] | string | Widget query. | | query | sort | [object] | Options for sorting results. | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | request_type [*required*] | enum | Widget request type. Allowed enum values: `slo_list` | | Option 28 | title | string | Title of the widget. | | Option 28 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 28 | title_size | string | Size of the title. | | Option 28 | type [*required*] | enum | Type of the SLO List widget. Allowed enum values: `slo_list` | | definition | Option 29 | object | Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on dashboards. | | Option 29 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 29 | description | string | The description of the widget. | | Option 29 | global_time_target | string | Defined global time target. | | Option 29 | show_error_budget | boolean | Defined error budget. | | Option 29 | slo_id | string | ID of the SLO displayed. | | Option 29 | time_windows | [string] | Times being monitored. | | Option 29 | title | string | Title of the widget. | | Option 29 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 29 | title_size | string | Size of the title. | | Option 29 | type [*required*] | enum | Type of the SLO widget. Allowed enum values: `slo` | | Option 29 | view_mode | enum | Define how you want the SLO to be displayed. Allowed enum values: `overall,component,both` | | Option 29 | view_type [*required*] | string | Type of view displayed by the widget. | | definition | Option 30 | object | The scatter plot visualization allows you to graph a chosen scope over two different metrics with their respective aggregation. | | Option 30 | color_by_groups | [string] | List of groups used for colors. | | Option 30 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 30 | description | string | The description of the widget. | | Option 30 | requests [*required*] | object | Widget definition. | | requests | table | object | Scatterplot request containing formulas and functions. | | table | formulas | [object] | List of Scatterplot formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Dimension of the Scatterplot. Allowed enum values: `x,y,radius,color` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | table | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | table | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | x | object | Updated scatter plot. | | x | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | x | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | x | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | q | string | Query definition. | | x | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | y | object | Updated scatter plot. | | y | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | y | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | y | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | q | string | Query definition. | | y | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 30 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 30 | title | string | Title of your widget. | | Option 30 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 30 | title_size | string | Size of the title. | | Option 30 | type [*required*] | enum | Type of the scatter plot widget. Allowed enum values: `scatterplot` | | Option 30 | xaxis | object | Axis controls for the widget. | | xaxis | include_zero | boolean | Set to `true` to include zero. | | xaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | xaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | xaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 30 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 31 | object | The Sankey diagram visualizes the flow of data between categories, stages or sets of values. | | Option 31 | requests [*required*] | [ ] | List of Sankey widget requests. | | requests | Option 1 | object | Sankey widget request for Product Analytics or RUM data source. | | Option 1 | query [*required*] | object | Query configuration for Product Analytics or RUM Sankey widget. | | query | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | query | data_source [*required*] | enum | Product Analytics or RUM data source type. Allowed enum values: `rum,product_analytics` | | query | entries_per_step | int64 | Entries per step. | | query | join_keys | object | Join keys. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | query | mode [*required*] | enum | Sankey mode for Product Analytics or RUM queries. Allowed enum values: `source,target` | | query | number_of_steps | int64 | Number of steps. | | query | occurrences | object | Filter applied to occurrence counts when building a Product Analytics audience. | | occurrences | operator | string | The comparison operator used for the occurrence filter (for example: `gt`, `lt`, `eq`). | | occurrences | value | string | The threshold value to compare occurrence counts against. | | query | query_string [*required*] | string | RUM event search query used to filter views or actions. | | query | source | string | Source. | | query | subquery_id | string | Subquery ID. | | query | target | string | Target. | | Option 1 | request_type [*required*] | enum | Type of the Sankey widget. Allowed enum values: `sankey` | | requests | Option 2 | object | Sankey widget request for network data source. | | Option 2 | query [*required*] | object | Query configuration for Sankey network widget. | | query | compute | object | Compute aggregation for network queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | string | Metric to aggregate. | | query | data_source [*required*] | enum | Network data source type. Allowed enum values: `network_device_flows,network` | | query | group_by [*required*] | [string] | Fields to group by. | | query | limit [*required*] | int64 | Maximum number of results. | | query | mode | enum | Sankey mode for network queries. Allowed enum values: `target` | | query | query_string [*required*] | string | Query string for filtering network data. | | query | should_exclude_missing | boolean | Whether to exclude missing values. | | query | sort | object | Sort configuration for network queries. | | sort | field | string | Field to sort by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | request_type [*required*] | enum | Type of request for network Sankey widget. Allowed enum values: `netflow_sankey` | | Option 31 | show_other_links | boolean | Whether to show links for "other" category. | | Option 31 | sort_nodes | boolean | Whether to sort nodes in the Sankey diagram. | | Option 31 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 31 | title | string | Title of your widget. | | Option 31 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 31 | title_size | string | Size of the title. | | Option 31 | type [*required*] | enum | Type of the Sankey widget. Allowed enum values: `sankey` | | definition | Option 32 | object | This widget displays a map of a service to all of the services that call it, and all of the services that it calls. | | Option 32 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 32 | description | string | The description of the widget. | | Option 32 | filters [*required*] | [string] | Your environment and primary tag (or * if enabled for your account). | | Option 32 | service [*required*] | string | The ID of the service you want to map. | | Option 32 | title | string | The title of your widget. | | Option 32 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 32 | title_size | string | Size of the title. | | Option 32 | type [*required*] | enum | Type of the service map widget. Allowed enum values: `servicemap` | | definition | Option 33 | object | The service summary displays the graphs of a chosen service in your dashboard. | | Option 33 | description | string | The description of the widget. | | Option 33 | display_format | enum | Number of columns to display. Allowed enum values: `one_column,two_column,three_column` | | Option 33 | env [*required*] | string | APM environment. | | Option 33 | service [*required*] | string | APM service. | | Option 33 | show_breakdown | boolean | Whether to show the latency breakdown or not. | | Option 33 | show_distribution | boolean | Whether to show the latency distribution or not. | | Option 33 | show_errors | boolean | Whether to show the error metrics or not. | | Option 33 | show_hits | boolean | Whether to show the hits metrics or not. | | Option 33 | show_latency | boolean | Whether to show the latency metrics or not. | | Option 33 | show_resource_list | boolean | Whether to show the resource list or not. | | Option 33 | size_format | enum | Size of the widget. Allowed enum values: `small,medium,large` | | Option 33 | span_name [*required*] | string | APM span name. | | Option 33 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 33 | title | string | Title of the widget. | | Option 33 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 33 | title_size | string | Size of the title. | | Option 33 | type [*required*] | enum | Type of the service summary widget. Allowed enum values: `trace_service` | | definition | Option 34 | object | The split graph widget allows you to create repeating units of a graph - one for each value in a group (for example: one per service) | | Option 34 | has_uniform_y_axes | boolean | Normalize y axes across graphs | | Option 34 | size [*required*] | enum | Size of the individual graphs in the split. Allowed enum values: `xs,sm,md,lg` | | Option 34 | source_widget_definition [*required*] | | The original widget we are splitting on. | | source_widget_definition | Option 1 | object | The bar chart visualization displays categorical data using vertical bars, allowing you to compare values across different groups. | | Option 1 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 1 | description | string | The description of the widget. | | Option 1 | requests [*required*] | [object] | List of bar chart widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 1 | style | object | Style customization for a bar chart widget. | | style | display | | Bar chart widget display options. | | display | Option 1 | object | Bar chart widget stacked display options. | | Option 1 | legend | enum | Bar chart widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Bar chart widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Bar chart widget flat display. | | Option 2 | type [*required*] | enum | Bar chart widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Bar chart widget scaling definition. Allowed enum values: `absolute,relative` | | Option 1 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 1 | title | string | Title of your widget. | | Option 1 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 1 | title_size | string | Size of the title. | | Option 1 | type [*required*] | enum | Type of the bar chart widget. Allowed enum values: `bar_chart` | | source_widget_definition | Option 2 | object | The Change graph shows you the change in a value over the time period chosen. | | Option 2 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 2 | description | string | The description of the widget. | | Option 2 | requests [*required*] | [object] | Array of one request object to display in the widget. | See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) to learn how to build the `REQUEST_SCHEMA`. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | change_type | enum | Show the absolute or the relative change. Allowed enum values: `absolute,relative` | | requests | compare_to | enum | Timeframe used for the change comparison. Allowed enum values: `hour_before,day_before,week_before,month_before` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | increase_good | boolean | Whether to show increase as good. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order_by | enum | What to order by. Allowed enum values: `change,name,present,past` | | requests | order_dir | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | show_present | boolean | Whether to show the present value. | | Option 2 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 2 | title | string | Title of the widget. | | Option 2 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 2 | title_size | string | Size of the title. | | Option 2 | type [*required*] | enum | Type of the change widget. Allowed enum values: `change` | | source_widget_definition | Option 3 | object | This visualization displays a series of values by country on a world map. | | Option 3 | custom_links | [object] | A list of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 3 | description | string | The description of the widget. | | Option 3 | requests [*required*] | [object] | Array of request objects to display in the widget. May include an optional request for the region layer and/or an optional request for the points layer. Region layer requests must contain a `group-by` tag whose value is a country ISO code. See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json.md) for information about building the `REQUEST_SCHEMA`. | | requests | columns | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | requests | conditional_formats | [object] | Threshold (numeric) conditional formatting rules may be used by a regions layer. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | query | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | The style to apply to the request for points layer. | | style | color_by | string | The category to color the points by. | | requests | text_formats | [object] | Text formatting rules may be used by a points layer. | | text_formats | custom_bg_color | string | Hex representation of the custom background color. Used with custom background palette option. | | text_formats | custom_fg_color | string | Hex representation of the custom text color. Used with custom text palette option. | | text_formats | match [*required*] | object | Match rule for the table widget text format. | | match | type [*required*] | enum | Match or compare option. Allowed enum values: `is,is_not,contains,does_not_contain,starts_with,ends_with` | | match | value [*required*] | string | Table Widget Match String. | | text_formats | palette | enum | Color-on-color palette to highlight replaced text. Allowed enum values: `white_on_red,white_on_yellow,white_on_green,black_on_light_red,black_on_light_yellow,black_on_light_green,red_on_white,yellow_on_white,green_on_white,custom_bg` | | text_formats | replace | | Replace rule for the table widget text format. | | replace | Option 1 | object | Match All definition. | | Option 1 | type [*required*] | enum | Table widget text format replace all type. Allowed enum values: `all` | | Option 1 | with [*required*] | string | Replace All type. | | replace | Option 2 | object | Match Sub-string definition. | | Option 2 | substring [*required*] | string | Text that will be replaced. | | Option 2 | type [*required*] | enum | Table widget text format replace sub-string type. Allowed enum values: `substring` | | Option 2 | with [*required*] | string | Text that will replace original sub-string. | | Option 3 | style [*required*] | object | The style to apply to the widget. | | style | palette [*required*] | string | The color palette to apply to the widget. | | style | palette_flip [*required*] | boolean | Whether to flip the palette tones. | | Option 3 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 3 | title | string | The title of your widget. | | Option 3 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 3 | title_size | string | The size of the title. | | Option 3 | type [*required*] | enum | Type of the geomap widget. Allowed enum values: `geomap` | | Option 3 | view [*required*] | object | The view of the world that the map should render. | | view | focus [*required*] | string | The 2-letter ISO code of a country to focus the map on, or `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`). | | source_widget_definition | Option 4 | object | Query values display the current value of a given metric, APM, or log query. | | Option 4 | autoscale | boolean | Whether to use auto-scaling or not. | | Option 4 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 4 | custom_unit | string | Display a unit of your choice on the widget. | | Option 4 | description | string | The description of the widget. | | Option 4 | precision | int64 | Number of decimals to show. If not defined, the widget uses the raw value. | | Option 4 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | comparison | object | Displays a change indicator showing a delta against a historical baseline. | | comparison | directionality | enum | Which direction of change is considered an improvement, determining the indicator color. Allowed enum values: `increase_better,decrease_better,neutral` | | comparison | duration [*required*] | object | The comparison period. Use a preset `type` value or set `type` to `custom_timeframe` and provide `custom_timeframe` with explicit millisecond epoch bounds. | | duration | custom_timeframe | object | Required when `type` is `custom_timeframe`. Fixed time range to compare against. | | custom_timeframe | from [*required*] | int64 | Start time in milliseconds since epoch. | | custom_timeframe | to [*required*] | int64 | End time in milliseconds since epoch. | | duration | type [*required*] | enum | The comparison window type. Allowed enum values: `previous_timeframe,custom_timeframe,previous_day,previous_week,previous_month` | | comparison | type | enum | How the delta is expressed: `absolute` (raw difference), `relative` (percentage), or `both`. Allowed enum values: `absolute,relative,both` | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | text_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 4 | timeseries_background | object | Set a timeseries on the widget background. | | timeseries_background | type [*required*] | enum | Timeseries is made using an area or bars. Allowed enum values: `bars,area` | | timeseries_background | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 4 | title | string | Title of your widget. | | Option 4 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 4 | title_size | string | Size of the title. | | Option 4 | type [*required*] | enum | Type of the query value widget. Allowed enum values: `query_value` | | source_widget_definition | Option 5 | object | The scatter plot visualization allows you to graph a chosen scope over two different metrics with their respective aggregation. | | Option 5 | color_by_groups | [string] | List of groups used for colors. | | Option 5 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 5 | description | string | The description of the widget. | | Option 5 | requests [*required*] | object | Widget definition. | | requests | table | object | Scatterplot request containing formulas and functions. | | table | formulas | [object] | List of Scatterplot formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | dimension [*required*] | enum | Dimension of the Scatterplot. Allowed enum values: `x,y,radius,color` | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | table | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | group_by | target | object | Target for user journey search. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | search | join_keys | object | Join keys for user journey queries. | | search | node_objects [*required*] | object | Node objects mapping. | | search | step_aliases | object | Step aliases mapping. | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | search | filters | object | Filters for retention queries. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | table | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | x | object | Updated scatter plot. | | x | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | x | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | x | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | q | string | Query definition. | | x | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | x | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | y | object | Updated scatter plot. | | y | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum` | | y | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | y | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | q | string | Query definition. | | y | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | y | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 5 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 5 | title | string | Title of your widget. | | Option 5 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 5 | title_size | string | Size of the title. | | Option 5 | type [*required*] | enum | Type of the scatter plot widget. Allowed enum values: `scatterplot` | | Option 5 | xaxis | object | Axis controls for the widget. | | xaxis | include_zero | boolean | Set to `true` to include zero. | | xaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | xaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | xaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | xaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 5 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | source_widget_definition | Option 6 | object | Sunbursts are spot on to highlight how groups contribute to the total of a query. | | Option 6 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 6 | description | string | The description of the widget. | | Option 6 | hide_total | boolean | Show the total value in this widget. | | Option 6 | legend | | Configuration of the legend. | | legend | Option 1 | object | Configuration of table-based legend. | | Option 1 | type [*required*] | enum | Whether or not to show a table legend. Allowed enum values: `table,none` | | legend | Option 2 | object | Configuration of inline or automatic legends. | | Option 2 | hide_percent | boolean | Whether to hide the percentages of the groups. | | Option 2 | hide_value | boolean | Whether to hide the values of the groups. | | Option 2 | type [*required*] | enum | Whether to show the legend inline or let it be automatically generated. Allowed enum values: `inline,automatic` | | Option 6 | requests [*required*] | [object] | List of sunburst widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 6 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 6 | title | string | Title of your widget. | | Option 6 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 6 | title_size | string | Size of the title. | | Option 6 | type [*required*] | enum | Type of the Sunburst widget. Allowed enum values: `sunburst` | | source_widget_definition | Option 7 | object | The table visualization is available on dashboards. It displays columns of metrics grouped by tag key. | | Option 7 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 7 | description | string | The description of the widget. | | Option 7 | has_search_bar | enum | Controls the display of the search bar. Allowed enum values: `always,never,auto` | | Option 7 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | alias | string | The column name (defaults to the metric name). | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | cell_display_mode | [string] | A list of display modes for each table cell. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | limit | int64 | For metric queries, the number of lines to show in the table. Only one request should have this property. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | text_formats | [array] | List of text formats for columns produced by tags. | | Option 7 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 7 | title | string | Title of your widget. | | Option 7 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 7 | title_size | string | Size of the title. | | Option 7 | type [*required*] | enum | Type of the table widget. Allowed enum values: `query_table` | | source_widget_definition | Option 8 | object | The timeseries visualization allows you to display the evolution of one or more metrics, log events, or Indexed Spans over time. | | Option 8 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 8 | description | string | The description of the widget. | | Option 8 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 8 | legend_columns | [string] | Columns displayed in the legend. | | Option 8 | legend_layout | enum | Layout of the legend. Allowed enum values: `auto,horizontal,vertical` | | Option 8 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 8 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 8 | requests [*required*] | [object] | List of timeseries widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 8 | right_yaxis | object | Axis controls for the widget. | | right_yaxis | include_zero | boolean | Set to `true` to include zero. | | right_yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | right_yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 8 | show_legend | boolean | (screenboard only) Show the legend for this widget. | | Option 8 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 8 | title | string | Title of your widget. | | Option 8 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 8 | title_size | string | Size of the title. | | Option 8 | type [*required*] | enum | Type of the timeseries widget. Allowed enum values: `timeseries` | | Option 8 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | source_widget_definition | Option 9 | object | The top list visualization enables you to display a list of Tag value like hostname or service with the most or least of any metric value, such as highest consumers of CPU, hosts with the least disk space, etc. | | Option 9 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 9 | description | string | The description of the widget. | | Option 9 | requests [*required*] | [object] | List of top list widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 9 | style | object | Style customization for a top list widget. | | style | display | | Top list widget display options. | | display | Option 1 | object | Top list widget stacked display options. | | Option 1 | legend | enum | Top list widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Top list widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Top list widget flat display. | | Option 2 | type [*required*] | enum | Top list widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Top list widget scaling definition. Allowed enum values: `absolute,relative` | | Option 9 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 9 | title | string | Title of your widget. | | Option 9 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 9 | title_size | string | Size of the title. | | Option 9 | type [*required*] | enum | Type of the top list widget. Allowed enum values: `toplist` | | source_widget_definition | Option 10 | object | The treemap visualization enables you to display hierarchical and nested data. It is well suited for queries that describe part-whole relationships, such as resource usage by availability zone, data center, or team. | | Option 10 | color_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine color in the widget. Allowed enum values: `user` | | Option 10 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 10 | description | string | The description of the widget. | | Option 10 | group_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to group elements in the widget. Allowed enum values: `user,family,process` | | Option 10 | requests [*required*] | [object] | List of treemap widget requests. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | graph_filters | [object] | Graph filters. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | return_criteria | time_interval | object | Time interval for return criteria. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 10 | size_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine size in the widget. Allowed enum values: `pct_cpu,pct_mem` | | Option 10 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 10 | title | string | Title of your widget. | | Option 10 | type [*required*] | enum | Type of the treemap widget. Allowed enum values: `treemap` | | Option 34 | split_config [*required*] | object | Encapsulates all user choices about how to split a graph. | | split_config | limit [*required*] | int64 | Maximum number of graphs to display in the widget. | | split_config | sort [*required*] | object | Controls the order in which graphs appear in the split. | | sort | compute | object | Defines the metric and aggregation used as the sort value. | | compute | aggregation [*required*] | string | How to aggregate the sort metric for the purposes of ordering. | | compute | metric [*required*] | string | The metric to use for sorting graphs. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | split_config | split_dimensions [*required*] | [object] | The dimension(s) on which to split the graph | | split_dimensions | one_graph_per [*required*] | string | The system interprets this attribute differently depending on the data source of the query being split. For metrics, it's a tag. For the events platform, it's an attribute or tag. | | split_config | static_splits | [array] | Manual selection of tags making split graph widget static | | Option 34 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 34 | title | string | Title of your widget. | | Option 34 | type [*required*] | enum | Type of the split graph widget Allowed enum values: `split_group` | | definition | Option 35 | object | Sunbursts are spot on to highlight how groups contribute to the total of a query. | | Option 35 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 35 | description | string | The description of the widget. | | Option 35 | hide_total | boolean | Show the total value in this widget. | | Option 35 | legend | | Configuration of the legend. | | legend | Option 1 | object | Configuration of table-based legend. | | Option 1 | type [*required*] | enum | Whether or not to show a table legend. Allowed enum values: `table,none` | | legend | Option 2 | object | Configuration of inline or automatic legends. | | Option 2 | hide_percent | boolean | Whether to hide the percentages of the groups. | | Option 2 | hide_value | boolean | Whether to hide the values of the groups. | | Option 2 | type [*required*] | enum | Whether to show the legend inline or let it be automatically generated. Allowed enum values: `inline,automatic` | | Option 35 | requests [*required*] | [object] | List of sunburst widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 35 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 35 | title | string | Title of your widget. | | Option 35 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 35 | title_size | string | Size of the title. | | Option 35 | type [*required*] | enum | Type of the Sunburst widget. Allowed enum values: `sunburst` | | definition | Option 36 | object | The table visualization is available on dashboards. It displays columns of metrics grouped by tag key. | | Option 36 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 36 | description | string | The description of the widget. | | Option 36 | has_search_bar | enum | Controls the display of the search bar. Allowed enum values: `always,never,auto` | | Option 36 | requests [*required*] | [object] | Widget definition. | | requests | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | requests | alias | string | The column name (defaults to the metric name). | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | requests | cell_display_mode | [string] | A list of display modes for each table cell. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | limit | int64 | For metric queries, the number of lines to show in the table. Only one request should have this property. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Query definition. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | text_formats | [array] | List of text formats for columns produced by tags. | | Option 36 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 36 | title | string | Title of your widget. | | Option 36 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 36 | title_size | string | Size of the title. | | Option 36 | type [*required*] | enum | Type of the table widget. Allowed enum values: `query_table` | | definition | Option 37 | object | The timeseries visualization allows you to display the evolution of one or more metrics, log events, or Indexed Spans over time. | | Option 37 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 37 | description | string | The description of the widget. | | Option 37 | events | [object] | **DEPRECATED**: List of widget events. Deprecated - Use `overlay` request type instead. | | events | q [*required*] | string | Query definition. | | events | tags_execution | string | The execution method for multi-value filters. | | Option 37 | legend_columns | [string] | Columns displayed in the legend. | | Option 37 | legend_layout | enum | Layout of the legend. Allowed enum values: `auto,horizontal,vertical` | | Option 37 | legend_size | string | Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto". | | Option 37 | markers | [object] | List of markers. | | markers | display_type | string | Combination of: | | markers | label | string | Label to display over the marker. | | markers | time | string | Timestamp for the widget. | | markers | value [*required*] | string | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. For Distribution widgets with `display_type` set to `percentile`, this should be a numeric percentile value (for example, "90" for P90). | | Option 37 | requests [*required*] | [object] | List of timeseries widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 37 | right_yaxis | object | Axis controls for the widget. | | right_yaxis | include_zero | boolean | Set to `true` to include zero. | | right_yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | right_yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | right_yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | Option 37 | show_legend | boolean | (screenboard only) Show the legend for this widget. | | Option 37 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 37 | title | string | Title of your widget. | | Option 37 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 37 | title_size | string | Size of the title. | | Option 37 | type [*required*] | enum | Type of the timeseries widget. Allowed enum values: `timeseries` | | Option 37 | yaxis | object | Axis controls for the widget. | | yaxis | include_zero | boolean | Set to `true` to include zero. | | yaxis | label | string | The label of the axis to display on the graph. Only usable on Scatterplot Widgets. | | yaxis | max | string | Specifies maximum numeric value to show on the axis. Defaults to `auto`. | | yaxis | min | string | Specifies minimum numeric value to show on the axis. Defaults to `auto`. | | yaxis | scale | string | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`). | | definition | Option 38 | object | The top list visualization enables you to display a list of Tag value like hostname or service with the most or least of any metric value, such as highest consumers of CPU, hosts with the least disk space, etc. | | Option 38 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 38 | description | string | The description of the widget. | | Option 38 | requests [*required*] | [object] | List of top list widget requests. | | requests | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | requests | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | requests | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 38 | style | object | Style customization for a top list widget. | | style | display | | Top list widget display options. | | display | Option 1 | object | Top list widget stacked display options. | | Option 1 | legend | enum | Top list widget stacked legend behavior. Allowed enum values: `automatic,inline,none` | | Option 1 | type [*required*] | enum | Top list widget stacked display type. Allowed enum values: `stacked` | | display | Option 2 | object | Top list widget flat display. | | Option 2 | type [*required*] | enum | Top list widget flat display type. Allowed enum values: `flat` | | style | palette | string | Color palette to apply to the widget. | | style | scaling | enum | Top list widget scaling definition. Allowed enum values: `absolute,relative` | | Option 38 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 38 | title | string | Title of your widget. | | Option 38 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 38 | title_size | string | Size of the title. | | Option 38 | type [*required*] | enum | Type of the top list widget. Allowed enum values: `toplist` | | definition | Option 39 | object | This widget displays a topology of nodes and edges for different data sources. It replaces the service map widget. | | Option 39 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 39 | description | string | The description of the widget. | | Option 39 | requests [*required*] | [object] | One or more Topology requests. | | requests | query | object | Query to service-based topology data sources like the service map or data streams. | | query | data_source | enum | Name of the data source Allowed enum values: `data_streams,service_map` | | query | filters | [string] | Your environment and primary tag (or * if enabled for your account). | | query | service | string | Name of the service | | requests | request_type | enum | Widget request type. Allowed enum values: `topology` | | Option 39 | title | string | Title of your widget. | | Option 39 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 39 | title_size | string | Size of the title. | | Option 39 | type [*required*] | enum | Type of the topology map widget. Allowed enum values: `topology_map` | | definition | Option 40 | object | The treemap visualization enables you to display hierarchical and nested data. It is well suited for queries that describe part-whole relationships, such as resource usage by availability zone, data center, or team. | | Option 40 | color_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine color in the widget. Allowed enum values: `user` | | Option 40 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 40 | description | string | The description of the widget. | | Option 40 | group_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to group elements in the widget. Allowed enum values: `user,family,process` | | Option 40 | requests [*required*] | [object] | List of treemap widget requests. | | requests | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | requests | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | requests | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | value | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | value | quantity | int64 | Quantity of the interval. | | value | timezone | string | Timezone for the interval. | | value | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | requests | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | requests | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | requests | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | Option 40 | size_by | enum | **DEPRECATED**: (deprecated) The attribute formerly used to determine size in the widget. Allowed enum values: `pct_cpu,pct_mem` | | Option 40 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 40 | title | string | Title of your widget. | | Option 40 | type [*required*] | enum | Type of the treemap widget. Allowed enum values: `treemap` | | definition | Option 41 | object | Custom visualization widget using Vega or Vega-Lite specifications. Combines standard Datadog data requests with a Vega or Vega-Lite JSON specification for flexible, custom visualizations. | | Option 41 | custom_links | [object] | List of custom links. | | custom_links | is_hidden | boolean | The flag for toggling context menu link visibility. | | custom_links | label | string | The label for the custom link URL. Keep the label short and descriptive. Use metrics and tags as variables. | | custom_links | link | string | The URL of the custom link. URL must include `http` or `https`. A relative URL must start with `/`. | | custom_links | override_label | string | The label ID that refers to a context menu link. Can be `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, or `rum`. | | Option 41 | requests [*required*] | [ ] | List of data requests for the wildcard widget. | | requests | Option 1 | object | An updated treemap widget. | | Option 1 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 1 | q | string | **DEPRECATED**: The widget metrics query. Deprecated - Use `queries` and `formulas` instead. | | Option 1 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 1 | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | Option 1 | sort | object | The controls for sorting the widget. | | sort | count | int64 | The number of items to limit the widget to. | | sort | order_by | [ ] | The array of items to sort the widget by in order. | | order_by | Option 1 | object | The formula to sort the widget by. | | Option 1 | index [*required*] | int64 | The index of the formula to sort by. | | Option 1 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 1 | type [*required*] | enum | Set the sort type to formula. Allowed enum values: `formula` | | order_by | Option 2 | object | The group to sort the widget by. | | Option 2 | name [*required*] | string | The name of the group. | | Option 2 | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | Option 2 | type [*required*] | enum | Set the sort type to group. Allowed enum values: `group` | | Option 1 | style | object | Define request widget style. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | requests | Option 2 | object | Updated timeseries widget. | | Option 2 | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | audit_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | audit_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | audit_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | audit_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | audit_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | audit_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | display_type | enum | Type of display to use for the request. Allowed enum values: `area,bars,line,overlay` | | Option 2 | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 2 | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | metadata | [object] | Used to define expression aliases. | | metadata | alias_name | string | Expression alias. | | metadata | expression [*required*] | string | Expression name. | | Option 2 | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | on_right_yaxis | boolean | Whether or not to display a second y-axis on the right. | | Option 2 | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | Option 2 | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | Option 2 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 2 | response_format | enum | Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets. Allowed enum values: `timeseries,scalar,event_list` | | Option 2 | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 2 | style | object | Define request widget style for timeseries widgets. | | style | has_value_labels | boolean | If true, the value is displayed as a label relative to the data point. | | style | line_type | enum | Type of lines displayed. Allowed enum values: `dashed,dotted,solid` | | style | line_width | enum | Width of line displayed. Allowed enum values: `normal,thick,thin` | | style | order_by | enum | How to order series in timeseries visualizations. | | style | palette | string | Color palette to apply to the widget. | | requests | Option 3 | object | Updated list stream widget. | | Option 3 | columns [*required*] | [object] | Widget columns. | | columns | field [*required*] | string | Widget column field. | | columns | width [*required*] | enum | Widget column width. Allowed enum values: `auto,compact,full` | | Option 3 | query [*required*] | object | Updated list stream widget. | | query | assignee_uuids | [string] | Filter by assignee UUIDs. Usable only with `issue_stream`. | | query | clustering_pattern_field_path | string | Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream. | | query | compute | [object] | Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source. | | compute | aggregation [*required*] | enum | Aggregation value. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | facet | string | Facet name. | | query | data_source [*required*] | enum | Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: `logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream` | | query | event_size | enum | Size to use to display an event. Allowed enum values: `s,l` | | query | group_by | [object] | Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source. | | group_by | facet [*required*] | string | Facet name. | | query | indexes | [string] | List of indexes. | | query | persona | enum | Persona filter for the `issue_stream` data source. Allowed enum values: `all,browser,mobile,backend` | | query | query_string [*required*] | string | Widget query. | | query | sort | object | Which column and order to sort by | | sort | column [*required*] | string | Facet path for the column | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | query | states | [string] | Filter by issue states. Usable only with `issue_stream`. | | query | storage | string | Option for storage location. Feature in Private Beta. | | query | suspected_causes | [string] | Filter by suspected causes. Usable only with `issue_stream`. | | query | team_handles | [string] | Filter by team handles. Usable only with `issue_stream`. | | Option 3 | response_format [*required*] | enum | Widget response format. Allowed enum values: `event_list` | | requests | Option 4 | object | Updated distribution widget. | | Option 4 | apm_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | apm_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | apm_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | apm_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | apm_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | apm_stats_query | object | The APM stats query for table and distributions widgets. | | apm_stats_query | columns | [object] | Column properties used by the front end for display. | | columns | alias | string | A user-assigned alias for the column. | | columns | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | columns | name [*required*] | string | Column name. | | columns | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | apm_stats_query | env [*required*] | string | Environment name. | | apm_stats_query | name [*required*] | string | Operation name associated with service. | | apm_stats_query | primary_tag [*required*] | string | The organization's host group name and value. | | apm_stats_query | resource | string | Resource name. | | apm_stats_query | row_type [*required*] | enum | The level of detail for the request. Allowed enum values: `service,resource,span` | | apm_stats_query | service [*required*] | string | Service name. | | Option 4 | event_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | event_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | event_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | event_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | event_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | event_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | formulas | [object] | List of formulas that operate on queries. | | formulas | alias | string | Expression alias. | | formulas | cell_display_mode | enum | Define a display mode for the table cell. Allowed enum values: `number,bar,trend` | | formulas | cell_display_mode_options | object | Cell display mode options for the widget formula. (only if `cell_display_mode` is set to `trend`). | | cell_display_mode_options | trend_type | enum | Trend type for the cell display mode options. Allowed enum values: `area,line,bars` | | cell_display_mode_options | y_scale | enum | Y scale for the cell display mode options. Allowed enum values: `shared,independent` | | formulas | conditional_formats | [object] | List of conditional formats. | | conditional_formats | comparator [*required*] | enum | Comparator to apply. Allowed enum values: `=,>,>=,<,<=` | | conditional_formats | custom_bg_color | string | Color palette to apply to the background, same values available as palette. | | conditional_formats | custom_fg_color | string | Color palette to apply to the foreground, same values available as palette. | | conditional_formats | hide_value | boolean | True hides values. | | conditional_formats | image_url | string | Displays an image as the background. | | conditional_formats | metric | string | Metric from the request to correlate this conditional format with. | | conditional_formats | palette [*required*] | enum | Color palette to apply. Allowed enum values: `blue,custom_bg,custom_image,custom_text,gray_on_white,grey,green,orange,red,red_on_white` | | conditional_formats | timeframe | string | Defines the displayed timeframe. | | conditional_formats | value [*required*] | double | Value for the comparator. | | formulas | formula [*required*] | string | String expression built from queries, formulas, and functions. | | formulas | limit | object | Options for limiting results returned. | | limit | count | int64 | Number of results to return. | | limit | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | formulas | number_format | object | Number format options for the widget. | | number_format | unit | | Number format unit. | | unit | Option 1 | object | Canonical unit. | | Option 1 | per_unit_name | string | The name of the unit per item. | | Option 1 | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | Option 1 | unit_name | string | The name of the unit. | | unit | Option 2 | object | Custom unit. | | Option 2 | label | string | The label for the custom unit. | | Option 2 | type | enum | The type of custom unit. Allowed enum values: `custom_unit_label` | | number_format | unit_scale | object | The definition of `NumberFormatUnitScale` object. | | unit_scale | type | enum | The type of unit scale. Allowed enum values: `canonical_unit` | | unit_scale | unit_name | string | The name of the unit. | | formulas | style | object | Styling options for widget formulas. | | style | palette | string | The color palette used to display the formula. A guide to the available color palettes can be found at [https://docs.datadoghq.com/dashboards/guide/widget_colors](https://docs.datadoghq.com/dashboards/guide/widget_colors.md) | | style | palette_index | int64 | Index specifying which color to use within the palette. | | Option 4 | log_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | log_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | log_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | log_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | log_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | log_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | network_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | network_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | network_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | network_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | network_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | network_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | process_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | process_query | filter_by | [string] | List of processes. | | process_query | limit | int64 | Max number of items in the filter list. | | process_query | metric [*required*] | string | Your chosen metric. | | process_query | search_by | string | Your chosen search term. | | Option 4 | profile_metrics_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | profile_metrics_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | profile_metrics_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | profile_metrics_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | profile_metrics_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | q | string | **DEPRECATED**: Widget query. Deprecated - Use `queries` and `formulas` instead. | | Option 4 | queries | [ ] | List of queries that can be returned directly or used in formulas. | | queries | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | queries | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | queries | Option 3 | object | Process query using formulas and functions. | | Option 3 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data sources that rely on the process backend. Allowed enum values: `process,container` | | Option 3 | is_normalized_cpu | boolean | Whether to normalize the CPU percentages. | | Option 3 | limit | int64 | Number of hits to return. | | Option 3 | metric [*required*] | string | Process metric name. | | Option 3 | name [*required*] | string | Name of query for use in formulas. | | Option 3 | sort | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 3 | tag_filters | [string] | An array of tags to filter by. | | Option 3 | text_filter | string | Text to use as filter. | | queries | Option 4 | object | A formula and functions APM dependency stats query. | | Option 4 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 4 | data_source [*required*] | enum | Data source for APM dependency stats queries. Allowed enum values: `apm_dependency_stats` | | Option 4 | env [*required*] | string | APM environment. | | Option 4 | is_upstream | boolean | Determines whether stats for upstream or downstream dependencies should be queried. | | Option 4 | name [*required*] | string | Name of query to use in formulas. | | Option 4 | operation_name [*required*] | string | Name of operation on service. | | Option 4 | primary_tag_name | string | The name of the second primary tag used within APM; required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog). | | Option 4 | primary_tag_value | string | Filter APM data by the second primary tag. `primary_tag_name` must also be specified. | | Option 4 | resource_name [*required*] | string | APM resource. | | Option 4 | service [*required*] | string | APM service. | | Option 4 | stat [*required*] | enum | APM statistic. Allowed enum values: `avg_duration,avg_root_duration,avg_spans_per_trace,error_rate,pct_exec_time,pct_of_traces,total_traces_count` | | queries | Option 5 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 5 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 5 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 5 | env [*required*] | string | APM environment. | | Option 5 | group_by | [string] | Array of fields to group results by. | | Option 5 | name [*required*] | string | Name of this query to use in formulas. | | Option 5 | operation_name | string | Name of operation on service. | | Option 5 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 5 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 5 | resource_name | string | APM resource name. | | Option 5 | service [*required*] | string | APM service name. | | Option 5 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | queries | Option 6 | object | A formula and functions APM metrics query. | | Option 6 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 6 | group_by | [string] | Optional fields to group the query results by. | | Option 6 | name [*required*] | string | Name of this query to use in formulas. | | Option 6 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 6 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 6 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 6 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 6 | resource_hash | string | The hash of a specific resource to filter by. | | Option 6 | resource_name | string | The full name of a specific resource to filter by. | | Option 6 | service | string | APM service name. | | Option 6 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 6 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | queries | Option 7 | object | A formula and functions metrics query. | | Option 7 | additional_query_filters | string | Additional filters applied to the SLO query. | | Option 7 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 7 | data_source [*required*] | enum | Data source for SLO measures queries. Allowed enum values: `slo` | | Option 7 | group_mode | enum | Group mode to query measures. Allowed enum values: `overall,components` | | Option 7 | measure [*required*] | enum | SLO measures queries. Allowed enum values: `good_events,bad_events,good_minutes,bad_minutes,slo_status,error_budget_remaining,burn_rate,error_budget_burndown` | | Option 7 | name | string | Name of the query for use in formulas. | | Option 7 | slo_id [*required*] | string | ID of an SLO to query measures. | | Option 7 | slo_query_type | enum | Name of the query for use in formulas. Allowed enum values: `metric,monitor,time_slice` | | queries | Option 8 | object | A formula and functions Cloud Cost query. | | Option 8 | aggregator | enum | Aggregator used for the request. Allowed enum values: `avg,last,max,min,sum,percentile` | | Option 8 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 8 | data_source [*required*] | enum | Data source for Cloud Cost queries. Allowed enum values: `cloud_cost` | | Option 8 | name [*required*] | string | Name of the query for use in formulas. | | Option 8 | query [*required*] | string | Query for Cloud Cost data. | | queries | Option 9 | object | A formula and functions Product Analytics Extended query for advanced analytics features. | | Option 9 | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | accounts | name | string | The name of the account subquery. | | accounts | query | string | The query string for the account subquery. | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | segments | name | string | The name of the segment subquery. | | segments | segment_id | string | The unique identifier of the segment. | | audience_filters | users | [object] | | users | name | string | The name of the user subquery. | | users | query | string | The query string for the user subquery. | | Option 9 | compute [*required*] | object | Compute configuration for Product Analytics Extended queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`. | | compute | metric | string | Measurable attribute to compute. | | compute | name | string | Name of the compute for use in formulas. | | compute | rollup | object | Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`. | | rollup | alignment | string | Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`). | | rollup | quantity | int64 | Quantity of the interval. | | rollup | timezone | string | Timezone for the interval. | | rollup | type [*required*] | enum | Type of calendar interval. Allowed enum values: `day,week,month,year,quarter,minute,hour` | | Option 9 | data_source [*required*] | enum | Data source for Product Analytics Extended queries. Allowed enum values: `product_analytics_extended` | | Option 9 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 9 | indexes | [string] | Event indexes to query. | | Option 9 | name [*required*] | string | Name of the query for use in formulas. | | Option 9 | query [*required*] | object | Base query for Product Analytics. | | query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | query | search [*required*] | object | Search configuration for Product Analytics event query. | | search | query [*required*] | string | RUM event search query used to filter views or actions. | | queries | Option 10 | object | A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data. | | Option 10 | compute [*required*] | object | Compute configuration for User Journey formula queries. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | double | Time bucket interval in milliseconds for time series queries. | | compute | metric | enum | Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`. Allowed enum values: `__dd.conversion,__dd.conversion_rate,__dd.time_to_convert` | | compute | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | data_source [*required*] | enum | Data source for user journey funnel queries. Allowed enum values: `product_analytics_journey` | | Option 10 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet name to group by. | | group_by | limit | int32 | Maximum number of groups to return. | | group_by | should_exclude_missing | boolean | Whether to exclude events missing the group-by facet. | | group_by | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | target | object | Target for user journey search. | | target | end | string | End value. | | target | start | string | Start value. | | target | type [*required*] | string | Target type. | | target | value | string | Target value. | | Option 10 | name [*required*] | string | Name of the query for use in formulas. | | Option 10 | search [*required*] | object | User journey search configuration. | | search | expression [*required*] | string | Expression string. | | search | filters | object | Filters for user journey search. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | graph_filters | [object] | Graph filters. | | graph_filters | name | string | Filter name. | | graph_filters | operator | string | Filter operator. | | graph_filters | target | object | Target for user journey search. | | graph_filters | value | int64 | Filter value. | | filters | string_filter | string | String filter. | | search | join_keys | object | Join keys for user journey queries. | | join_keys | primary [*required*] | string | Primary join key. | | join_keys | secondary | [string] | Secondary join keys. | | search | node_objects [*required*] | object | Node objects mapping. | | additionalProperties | | object | Base query for Product Analytics. | | | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | | search [*required*] | object | Search configuration for Product Analytics event query. | | search | step_aliases | object | Step aliases mapping. | | additionalProperties | | string | | queries | Option 11 | object | A formula and functions Retention query for defining timeseries and scalar visualizations. | | Option 11 | compute [*required*] | object | Compute configuration for retention queries. | | compute | aggregation [*required*] | | The type of aggregation that can be performed on events-based queries. | | aggregation | Option 1 | enum | Standard aggregation types for events-based queries. Allowed enum values: `avg,cardinality,count,delta,earliest,latest,max,median,min,most_frequent` | | aggregation | Option 2 | string | Percentile aggregation. | | compute | metric [*required*] | enum | Metric for retention compute. Allowed enum values: `__dd.retention,__dd.retention_rate` | | Option 11 | data_source [*required*] | enum | Data source for retention queries. Allowed enum values: `product_analytics_retention` | | Option 11 | group_by | [object] | Group by configuration. | | group_by | facet [*required*] | string | Facet to group by. | | group_by | limit | int64 | Maximum number of groups. | | group_by | should_exclude_missing | boolean | Whether to exclude missing values. | | group_by | sort | object | Sort configuration for retention group by. | | sort | order | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | group_by | source | string | Source field. | | group_by | target [*required*] | enum | Target for retention group by. Allowed enum values: `cohort,return_period` | | Option 11 | name [*required*] | string | Name of the query for use in formulas. | | Option 11 | search [*required*] | object | Search configuration for retention queries. | | search | cohort_criteria [*required*] | object | Cohort criteria for retention queries. | | cohort_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | cohort_criteria | time_interval [*required*] | object | Time interval for cohort criteria. | | time_interval | type [*required*] | enum | Type of time interval for cohort criteria. Allowed enum values: `calendar` | | time_interval | value [*required*] | object | Calendar interval definition. | | search | filters | object | Filters for retention queries. | | filters | audience_filters | object | Product Analytics/RUM audience filters. | | audience_filters | accounts | [object] | | audience_filters | filter_condition | string | An optional filter condition applied to the audience subquery. | | audience_filters | segments | [object] | | audience_filters | users | [object] | | filters | string_filter | string | String filter. | | search | retention_entity [*required*] | enum | Entity to track for retention. Allowed enum values: `@usr.id,@account.id` | | search | return_condition [*required*] | enum | Condition for counting user return. Allowed enum values: `conversion_on,conversion_on_or_after` | | search | return_criteria | object | Return criteria for retention queries. | | return_criteria | base_query [*required*] | object | Base query for Product Analytics. | | base_query | data_source [*required*] | enum | Data source for Product Analytics event queries. Allowed enum values: `product_analytics` | | base_query | search [*required*] | object | Search configuration for Product Analytics event query. | | return_criteria | time_interval | object | Time interval for return criteria. | | time_interval | type [*required*] | enum | Type of time interval for return criteria. Allowed enum values: `fixed` | | time_interval | unit [*required*] | enum | Unit of time for retention return criteria interval. Allowed enum values: `day,week,month` | | time_interval | value [*required*] | double | Value of the time interval. | | Option 4 | query | | Query definition for Distribution Widget Histogram Request | | query | Option 1 | object | A formula and functions metrics query. | | Option 1 | aggregator | enum | The aggregation methods available for metrics queries. Allowed enum values: `avg,min,max,sum,last,area,l2norm,percentile` | | Option 1 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 1 | data_source [*required*] | enum | Data source for metrics queries. Allowed enum values: `metrics` | | Option 1 | name [*required*] | string | Name of the query for use in formulas. | | Option 1 | query [*required*] | string | Metrics query definition. | | Option 1 | semantic_mode | enum | Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed. Allowed enum values: `combined,native` | | query | Option 2 | object | A formula and functions events query. | | Option 2 | compute [*required*] | object | Compute options. | | compute | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | compute | interval | int64 | A time interval in milliseconds. | | compute | metric | string | Measurable attribute to compute. | | Option 2 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 2 | data_source [*required*] | enum | Data source for event platform-based queries. Allowed enum values: `logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines` | | Option 2 | group_by | | Group by configuration for a formula and functions events query. Accepts either a list of facet objects or a flat object that specifies a list of facet fields. | | group_by | Option 1 | [object] | List of objects used to group by. | | Option 1 | facet [*required*] | string | Event facet. | | Option 1 | limit | int64 | Number of groups to return. | | Option 1 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | group_by | Option 2 | object | Flat group by configuration using multiple event facet fields. | | Option 2 | fields [*required*] | [string] | List of event facets to group by. | | Option 2 | limit | int64 | Number of groups to return. | | Option 2 | sort | object | Options for sorting group by results. | | sort | aggregation [*required*] | enum | Aggregation methods for event platform queries. Allowed enum values: `count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min` | | sort | metric | string | Metric used for sorting group by results. | | sort | order | enum | Direction of sort. Allowed enum values: `asc,desc` | | Option 2 | indexes | [string] | An array of index names to query in the stream. Omit or use `[]` to query all indexes at once. | | Option 2 | name [*required*] | string | Name of the query for use in formulas. | | Option 2 | search | object | Search options. | | search | query [*required*] | string | Events search string. | | Option 2 | storage | string | Option for storage location. Feature in Private Beta. | | query | Option 3 | object | **DEPRECATED**: APM resource stats query using formulas and functions. Deprecated - Use `apm_metrics` query type instead. | | Option 3 | cross_org_uuids | [string] | The source organization UUID for cross organization queries. Feature in Private Beta. | | Option 3 | data_source [*required*] | enum | Data source for APM resource stats queries. Allowed enum values: `apm_resource_stats` | | Option 3 | env [*required*] | string | APM environment. | | Option 3 | group_by | [string] | Array of fields to group results by. | | Option 3 | name [*required*] | string | Name of this query to use in formulas. | | Option 3 | operation_name | string | Name of operation on service. | | Option 3 | primary_tag_name | string | Name of the second primary tag used within APM. Required when `primary_tag_value` is specified. See [https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope/#add-a-second-primary-tag-in-datadog](https://docs.datadoghq.com/tracing/guide/setting_primary_tags_to_scope.md#add-a-second-primary-tag-in-datadog) | | Option 3 | primary_tag_value | string | Value of the second primary tag by which to filter APM data. `primary_tag_name` must also be specified. | | Option 3 | resource_name | string | APM resource name. | | Option 3 | service [*required*] | string | APM service name. | | Option 3 | stat [*required*] | enum | APM resource stat name. Allowed enum values: `errors,error_rate,hits,latency_avg,latency_distribution,latency_max,latency_p50,latency_p75,latency_p90,latency_p95` | | query | Option 4 | object | A formula and functions APM metrics query. | | Option 4 | data_source [*required*] | enum | Data source for APM metrics queries. Allowed enum values: `apm_metrics` | | Option 4 | group_by | [string] | Optional fields to group the query results by. | | Option 4 | name [*required*] | string | Name of this query to use in formulas. | | Option 4 | operation_mode | string | Optional operation mode to aggregate across operation names. | | Option 4 | operation_name | string | Name of operation on service. If not provided, the primary operation name is used. | | Option 4 | peer_tags | [string] | Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.). | | Option 4 | query_filter | string | Additional filters for the query using metrics query syntax (e.g., env, primary_tag). | | Option 4 | resource_hash | string | The hash of a specific resource to filter by. | | Option 4 | resource_name | string | The full name of a specific resource to filter by. | | Option 4 | service | string | APM service name. | | Option 4 | span_kind | enum | Describes the relationship between the span, its parents, and its children in a trace. Allowed enum values: `consumer,server,client,producer,internal` | | Option 4 | stat [*required*] | enum | APM metric stat name. Allowed enum values: `errors,error_rate,errors_per_second,latency_avg,latency_max,latency_p50,latency_p75,latency_p90,latency_p95,latency_p99` | | Option 4 | request_type | enum | Distribution of point values for distribution metrics. Renders a histogram of raw metric data points. Allowed enum values: `histogram` | | Option 4 | response_format | enum | Distribution of aggregated grouped queries. Use `request_type` instead for distribution of point values from distribution metrics. Allowed enum values: `timeseries,scalar,event_list` | | Option 4 | rum_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | rum_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | rum_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | rum_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | rum_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | rum_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | security_query | object | **DEPRECATED**: Deprecated - Use `queries` and `formulas` instead. | | security_query | compute | object | Define computation for a log query. | | compute | aggregation [*required*] | string | The aggregation method. | | compute | facet | string | Facet name. | | compute | interval | int64 | Define a time interval in seconds. | | security_query | group_by | [object] | List of tag prefixes to group by in the case of a cluster check. | | group_by | facet [*required*] | string | Facet name. | | group_by | limit | int64 | Maximum number of items in the group. | | group_by | sort | object | Define a sorting method. | | sort | aggregation [*required*] | string | The aggregation method. | | sort | facet | string | Facet name. | | sort | order [*required*] | enum | Widget sorting methods. Allowed enum values: `asc,desc` | | security_query | index | string | A coma separated-list of index names. Use "*" query all indexes at once. [Multiple Indexes](https://docs.datadoghq.com/logs/indexes.md#multiple-indexes) | | security_query | multi_compute | [object] | This field is mutually exclusive with `compute`. | | multi_compute | aggregation [*required*] | string | The aggregation method. | | multi_compute | facet | string | Facet name. | | multi_compute | interval | int64 | Define a time interval in seconds. | | security_query | search | object | The query being made on the logs. | | search | query [*required*] | string | Search value to apply. | | Option 4 | style | object | Widget style definition. | | style | palette | string | Color palette to apply to the widget. | | Option 41 | specification [*required*] | object | Vega or Vega-Lite specification for custom visualization rendering. See [https://vega.github.io/vega-lite/](https://vega.github.io/vega-lite/) for the full grammar reference. | | specification | contents [*required*] | object | The Vega or Vega-Lite JSON specification object. | | specification | type [*required*] | enum | Type of specification used by the wildcard widget. Allowed enum values: `vega,vega-lite` | | Option 41 | time | | Time setting for the widget. | | time | Option 1 | object | Wrapper for live span | | Option 1 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 1 | live_span | enum | The available timeframes depend on the widget you are using. Allowed enum values: `1m,5m,10m,15m,30m,1h,4h,1d,2d,1w` | | time | Option 2 | object | Used for arbitrary live span times, such as 17 minutes or 6 hours. | | Option 2 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 2 | type [*required*] | enum | Type "live" denotes a live span in the new format. Allowed enum values: `live` | | Option 2 | unit [*required*] | enum | Unit of the time span. Allowed enum values: `minute,hour,day,week,month,year` | | Option 2 | value [*required*] | int64 | Value of the time span. | | time | Option 3 | object | Used for fixed span times, such as 'March 1 to March 7'. | | Option 3 | from [*required*] | int64 | Start time in milliseconds since epoch. | | Option 3 | hide_incomplete_cost_data | boolean | Whether to hide incomplete cost data in the widget. | | Option 3 | to [*required*] | int64 | End time in milliseconds since epoch. | | Option 3 | type [*required*] | enum | Type "fixed" denotes a fixed span. Allowed enum values: `fixed` | | Option 41 | title | string | Title of the widget. | | Option 41 | title_align | enum | How to align the text on the widget. Allowed enum values: `center,left,right` | | Option 41 | title_size | string | Size of the title. | | Option 41 | type [*required*] | enum | Type of the wildcard widget. Allowed enum values: `wildcard` | | widgets | id | int64 | ID of the widget. | | widgets | layout | object | The layout for a widget on a `free` or **new dashboard layout** dashboard. | | layout | height [*required*] | int64 | The height of the widget. Should be a non-negative integer. | | layout | is_column_break | boolean | Whether the widget should be the first one on the second column in high density or not. **Note**: Only for the **new dashboard layout** and only one widget in the dashboard should have this property set to `true`. | | layout | width [*required*] | int64 | The width of the widget. Should be a non-negative integer. | | layout | x [*required*] | int64 | The position of the widget on the x (horizontal) axis. Should be a non-negative integer. | | layout | y [*required*] | int64 | The position of the widget on the y (vertical) axis. Should be a non-negative integer. | {% /tab %} {% tab title="Example" %} ```json { "author_handle": "test@datadoghq.com", "author_name": "John Doe", "created_at": "2019-09-19T10:00:00.000Z", "description": "string", "id": "123-abc-456", "is_read_only": false, "layout_type": "ordered", "modified_at": "2019-09-19T10:00:00.000Z", "notify_list": [], "reflow_type": "string", "restricted_roles": [], "tabs": [ { "id": "", "name": "L", "widget_ids": [ 0 ] } ], "tags": [], "template_variable_presets": [ { "name": "string", "template_variables": [ { "name": "string", "value": "string", "values": [] } ] } ], "template_variables": [ { "available_values": [ "my-host", "host1", "host2" ], "default": "my-host", "defaults": [ "my-host-1", "my-host-2" ], "name": "host1", "prefix": "host", "type": "group" } ], "title": "", "url": "/dashboard/123-abc-456/example-dashboard-title", "widgets": [ { "definition": { "requests": { "fill": { "q": "avg:system.cpu.user{*}" } }, "type": "hostmap" }, "id": "integer", "layout": { "height": 0, "is_column_break": false, "width": 0, "x": 0, "y": 0 } } ] } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Authentication Error {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="404" %} Item Not Found {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \## default # \# Path parameters export dashboard_id="CHANGE_ME" \# Curl command curl -X PUT "https://api.datadoghq.com/api/v1/dashboard/${dashboard_id}" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "description": "An example dashboard for monitoring infrastructure.", "layout_type": "ordered", "title": "Example Dashboard", "widgets": [ { "definition": { "requests": [ { "q": "avg:system.cpu.user{*}" } ], "title": "CPU Usage", "type": "timeseries" } } ] } EOF ##### \## default # \# Path parameters export dashboard_id="CHANGE_ME" \# Curl command curl -X PUT "https://api.datadoghq.com/api/v1/dashboard/${dashboard_id}" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "description": "An example dashboard for monitoring infrastructure.", "layout_type": "ordered", "title": "Example Dashboard", "widgets": [ { "definition": { "requests": [ { "q": "avg:system.cpu.user{*}" } ], "title": "CPU Usage", "type": "timeseries" } } ] } EOF ##### ```go // Update a dashboard returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { // there is a valid "dashboard" in the system DashboardID := os.Getenv("DASHBOARD_ID") body := datadogV1.Dashboard{ LayoutType: datadogV1.DASHBOARDLAYOUTTYPE_ORDERED, Title: "Example-Dashboard with list_stream widget", Description: *datadog.NewNullableString(datadog.PtrString("Updated description")), Widgets: []datadogV1.Widget{ { Definition: datadogV1.WidgetDefinition{ ListStreamWidgetDefinition: &datadogV1.ListStreamWidgetDefinition{ Type: datadogV1.LISTSTREAMWIDGETDEFINITIONTYPE_LIST_STREAM, Requests: []datadogV1.ListStreamWidgetRequest{ { Columns: []datadogV1.ListStreamColumn{ { Width: datadogV1.LISTSTREAMCOLUMNWIDTH_AUTO, Field: "timestamp", }, }, Query: datadogV1.ListStreamQuery{ DataSource: datadogV1.LISTSTREAMSOURCE_APM_ISSUE_STREAM, QueryString: "", }, ResponseFormat: datadogV1.LISTSTREAMRESPONSEFORMAT_EVENT_LIST, }, }, }}, }, }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewDashboardsApi(apiClient) resp, r, err := api.UpdateDashboard(ctx, DashboardID, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `DashboardsApi.UpdateDashboard`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `DashboardsApi.UpdateDashboard`:\n%s\n", responseContent) } ``` ##### ```go // Update a dashboard with tags returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { // there is a valid "dashboard" in the system DashboardID := os.Getenv("DASHBOARD_ID") body := datadogV1.Dashboard{ LayoutType: datadogV1.DASHBOARDLAYOUTTYPE_ORDERED, Title: "Example-Dashboard with list_stream widget", Description: *datadog.NewNullableString(datadog.PtrString("Updated description")), Tags: *datadog.NewNullableList(&[]string{ "team:foo", "team:bar", }), Widgets: []datadogV1.Widget{ { Definition: datadogV1.WidgetDefinition{ ListStreamWidgetDefinition: &datadogV1.ListStreamWidgetDefinition{ Type: datadogV1.LISTSTREAMWIDGETDEFINITIONTYPE_LIST_STREAM, Requests: []datadogV1.ListStreamWidgetRequest{ { Columns: []datadogV1.ListStreamColumn{ { Width: datadogV1.LISTSTREAMCOLUMNWIDTH_AUTO, Field: "timestamp", }, }, Query: datadogV1.ListStreamQuery{ DataSource: datadogV1.LISTSTREAMSOURCE_APM_ISSUE_STREAM, QueryString: "", }, ResponseFormat: datadogV1.LISTSTREAMRESPONSEFORMAT_EVENT_LIST, }, }, }}, }, }, } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewDashboardsApi(apiClient) resp, r, err := api.UpdateDashboard(ctx, DashboardID, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `DashboardsApi.UpdateDashboard`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `DashboardsApi.UpdateDashboard`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // Update a dashboard returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.DashboardsApi; import com.datadog.api.client.v1.model.Dashboard; import com.datadog.api.client.v1.model.DashboardLayoutType; import com.datadog.api.client.v1.model.ListStreamColumn; import com.datadog.api.client.v1.model.ListStreamColumnWidth; import com.datadog.api.client.v1.model.ListStreamQuery; import com.datadog.api.client.v1.model.ListStreamResponseFormat; import com.datadog.api.client.v1.model.ListStreamSource; import com.datadog.api.client.v1.model.ListStreamWidgetDefinition; import com.datadog.api.client.v1.model.ListStreamWidgetDefinitionType; import com.datadog.api.client.v1.model.ListStreamWidgetRequest; import com.datadog.api.client.v1.model.Widget; import com.datadog.api.client.v1.model.WidgetDefinition; import java.util.Collections; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); DashboardsApi apiInstance = new DashboardsApi(defaultClient); // there is a valid "dashboard" in the system String DASHBOARD_ID = System.getenv("DASHBOARD_ID"); Dashboard body = new Dashboard() .layoutType(DashboardLayoutType.ORDERED) .title("Example-Dashboard with list_stream widget") .description("Updated description") .widgets( Collections.singletonList( new Widget() .definition( new WidgetDefinition( new ListStreamWidgetDefinition() .type(ListStreamWidgetDefinitionType.LIST_STREAM) .requests( Collections.singletonList( new ListStreamWidgetRequest() .columns( Collections.singletonList( new ListStreamColumn() .width(ListStreamColumnWidth.AUTO) .field("timestamp"))) .query( new ListStreamQuery() .dataSource( ListStreamSource.APM_ISSUE_STREAM) .queryString("")) .responseFormat( ListStreamResponseFormat.EVENT_LIST))))))); try { Dashboard result = apiInstance.updateDashboard(DASHBOARD_ID, body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling DashboardsApi#updateDashboard"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` ##### ```java // Update a dashboard with tags returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.DashboardsApi; import com.datadog.api.client.v1.model.Dashboard; import com.datadog.api.client.v1.model.DashboardLayoutType; import com.datadog.api.client.v1.model.ListStreamColumn; import com.datadog.api.client.v1.model.ListStreamColumnWidth; import com.datadog.api.client.v1.model.ListStreamQuery; import com.datadog.api.client.v1.model.ListStreamResponseFormat; import com.datadog.api.client.v1.model.ListStreamSource; import com.datadog.api.client.v1.model.ListStreamWidgetDefinition; import com.datadog.api.client.v1.model.ListStreamWidgetDefinitionType; import com.datadog.api.client.v1.model.ListStreamWidgetRequest; import com.datadog.api.client.v1.model.Widget; import com.datadog.api.client.v1.model.WidgetDefinition; import java.util.Arrays; import java.util.Collections; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); DashboardsApi apiInstance = new DashboardsApi(defaultClient); // there is a valid "dashboard" in the system String DASHBOARD_ID = System.getenv("DASHBOARD_ID"); Dashboard body = new Dashboard() .layoutType(DashboardLayoutType.ORDERED) .title("Example-Dashboard with list_stream widget") .description("Updated description") .tags(Arrays.asList("team:foo", "team:bar")) .widgets( Collections.singletonList( new Widget() .definition( new WidgetDefinition( new ListStreamWidgetDefinition() .type(ListStreamWidgetDefinitionType.LIST_STREAM) .requests( Collections.singletonList( new ListStreamWidgetRequest() .columns( Collections.singletonList( new ListStreamColumn() .width(ListStreamColumnWidth.AUTO) .field("timestamp"))) .query( new ListStreamQuery() .dataSource( ListStreamSource.APM_ISSUE_STREAM) .queryString("")) .responseFormat( ListStreamResponseFormat.EVENT_LIST))))))); try { Dashboard result = apiInstance.updateDashboard(DASHBOARD_ID, body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling DashboardsApi#updateDashboard"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```python """ Update a dashboard returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.dashboards_api import DashboardsApi from datadog_api_client.v1.model.dashboard import Dashboard from datadog_api_client.v1.model.dashboard_layout_type import DashboardLayoutType from datadog_api_client.v1.model.list_stream_column import ListStreamColumn from datadog_api_client.v1.model.list_stream_column_width import ListStreamColumnWidth from datadog_api_client.v1.model.list_stream_query import ListStreamQuery from datadog_api_client.v1.model.list_stream_response_format import ListStreamResponseFormat from datadog_api_client.v1.model.list_stream_source import ListStreamSource from datadog_api_client.v1.model.list_stream_widget_definition import ListStreamWidgetDefinition from datadog_api_client.v1.model.list_stream_widget_definition_type import ListStreamWidgetDefinitionType from datadog_api_client.v1.model.list_stream_widget_request import ListStreamWidgetRequest from datadog_api_client.v1.model.widget import Widget # there is a valid "dashboard" in the system DASHBOARD_ID = environ["DASHBOARD_ID"] body = Dashboard( layout_type=DashboardLayoutType.ORDERED, title="Example-Dashboard with list_stream widget", description="Updated description", widgets=[ Widget( definition=ListStreamWidgetDefinition( type=ListStreamWidgetDefinitionType.LIST_STREAM, requests=[ ListStreamWidgetRequest( columns=[ ListStreamColumn( width=ListStreamColumnWidth.AUTO, field="timestamp", ), ], query=ListStreamQuery( data_source=ListStreamSource.APM_ISSUE_STREAM, query_string="", ), response_format=ListStreamResponseFormat.EVENT_LIST, ), ], ), ), ], ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = DashboardsApi(api_client) response = api_instance.update_dashboard(dashboard_id=DASHBOARD_ID, body=body) print(response) ``` ##### ```python """ Update a dashboard with tags returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.dashboards_api import DashboardsApi from datadog_api_client.v1.model.dashboard import Dashboard from datadog_api_client.v1.model.dashboard_layout_type import DashboardLayoutType from datadog_api_client.v1.model.list_stream_column import ListStreamColumn from datadog_api_client.v1.model.list_stream_column_width import ListStreamColumnWidth from datadog_api_client.v1.model.list_stream_query import ListStreamQuery from datadog_api_client.v1.model.list_stream_response_format import ListStreamResponseFormat from datadog_api_client.v1.model.list_stream_source import ListStreamSource from datadog_api_client.v1.model.list_stream_widget_definition import ListStreamWidgetDefinition from datadog_api_client.v1.model.list_stream_widget_definition_type import ListStreamWidgetDefinitionType from datadog_api_client.v1.model.list_stream_widget_request import ListStreamWidgetRequest from datadog_api_client.v1.model.widget import Widget # there is a valid "dashboard" in the system DASHBOARD_ID = environ["DASHBOARD_ID"] body = Dashboard( layout_type=DashboardLayoutType.ORDERED, title="Example-Dashboard with list_stream widget", description="Updated description", tags=[ "team:foo", "team:bar", ], widgets=[ Widget( definition=ListStreamWidgetDefinition( type=ListStreamWidgetDefinitionType.LIST_STREAM, requests=[ ListStreamWidgetRequest( columns=[ ListStreamColumn( width=ListStreamColumnWidth.AUTO, field="timestamp", ), ], query=ListStreamQuery( data_source=ListStreamSource.APM_ISSUE_STREAM, query_string="", ), response_format=ListStreamResponseFormat.EVENT_LIST, ), ], ), ), ], ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = DashboardsApi(api_client) response = api_instance.update_dashboard(dashboard_id=DASHBOARD_ID, body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # Update a dashboard returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V1::DashboardsAPI.new # there is a valid "dashboard" in the system DASHBOARD_ID = ENV["DASHBOARD_ID"] body = DatadogAPIClient::V1::Dashboard.new({ layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED, title: "Example-Dashboard with list_stream widget", description: "Updated description", widgets: [ DatadogAPIClient::V1::Widget.new({ definition: DatadogAPIClient::V1::ListStreamWidgetDefinition.new({ type: DatadogAPIClient::V1::ListStreamWidgetDefinitionType::LIST_STREAM, requests: [ DatadogAPIClient::V1::ListStreamWidgetRequest.new({ columns: [ DatadogAPIClient::V1::ListStreamColumn.new({ width: DatadogAPIClient::V1::ListStreamColumnWidth::AUTO, field: "timestamp", }), ], query: DatadogAPIClient::V1::ListStreamQuery.new({ data_source: DatadogAPIClient::V1::ListStreamSource::APM_ISSUE_STREAM, query_string: "", }), response_format: DatadogAPIClient::V1::ListStreamResponseFormat::EVENT_LIST, }), ], }), }), ], }) p api_instance.update_dashboard(DASHBOARD_ID, body) ``` ##### ```ruby # Update a dashboard with tags returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V1::DashboardsAPI.new # there is a valid "dashboard" in the system DASHBOARD_ID = ENV["DASHBOARD_ID"] body = DatadogAPIClient::V1::Dashboard.new({ layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED, title: "Example-Dashboard with list_stream widget", description: "Updated description", tags: [ "team:foo", "team:bar", ], widgets: [ DatadogAPIClient::V1::Widget.new({ definition: DatadogAPIClient::V1::ListStreamWidgetDefinition.new({ type: DatadogAPIClient::V1::ListStreamWidgetDefinitionType::LIST_STREAM, requests: [ DatadogAPIClient::V1::ListStreamWidgetRequest.new({ columns: [ DatadogAPIClient::V1::ListStreamColumn.new({ width: DatadogAPIClient::V1::ListStreamColumnWidth::AUTO, field: "timestamp", }), ], query: DatadogAPIClient::V1::ListStreamQuery.new({ data_source: DatadogAPIClient::V1::ListStreamSource::APM_ISSUE_STREAM, query_string: "", }), response_format: DatadogAPIClient::V1::ListStreamResponseFormat::EVENT_LIST, }), ], }), }), ], }) p api_instance.update_dashboard(DASHBOARD_ID, body) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```rust // Update a dashboard returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_dashboards::DashboardsAPI; use datadog_api_client::datadogV1::model::Dashboard; use datadog_api_client::datadogV1::model::DashboardLayoutType; use datadog_api_client::datadogV1::model::ListStreamColumn; use datadog_api_client::datadogV1::model::ListStreamColumnWidth; use datadog_api_client::datadogV1::model::ListStreamQuery; use datadog_api_client::datadogV1::model::ListStreamResponseFormat; use datadog_api_client::datadogV1::model::ListStreamSource; use datadog_api_client::datadogV1::model::ListStreamWidgetDefinition; use datadog_api_client::datadogV1::model::ListStreamWidgetDefinitionType; use datadog_api_client::datadogV1::model::ListStreamWidgetRequest; use datadog_api_client::datadogV1::model::Widget; use datadog_api_client::datadogV1::model::WidgetDefinition; #[tokio::main] async fn main() { // there is a valid "dashboard" in the system let dashboard_id = std::env::var("DASHBOARD_ID").unwrap(); let body = Dashboard::new( DashboardLayoutType::ORDERED, "Example-Dashboard with list_stream widget".to_string(), vec![Widget::new(WidgetDefinition::ListStreamWidgetDefinition( Box::new(ListStreamWidgetDefinition::new( vec![ListStreamWidgetRequest::new( vec![ListStreamColumn::new( "timestamp".to_string(), ListStreamColumnWidth::AUTO, )], ListStreamQuery::new(ListStreamSource::APM_ISSUE_STREAM, "".to_string()), ListStreamResponseFormat::EVENT_LIST, )], ListStreamWidgetDefinitionType::LIST_STREAM, )), ))], ) .description(Some("Updated description".to_string())); let configuration = datadog::Configuration::new(); let api = DashboardsAPI::with_config(configuration); let resp = api.update_dashboard(dashboard_id.clone(), body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` ##### ```rust // Update a dashboard with tags returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_dashboards::DashboardsAPI; use datadog_api_client::datadogV1::model::Dashboard; use datadog_api_client::datadogV1::model::DashboardLayoutType; use datadog_api_client::datadogV1::model::ListStreamColumn; use datadog_api_client::datadogV1::model::ListStreamColumnWidth; use datadog_api_client::datadogV1::model::ListStreamQuery; use datadog_api_client::datadogV1::model::ListStreamResponseFormat; use datadog_api_client::datadogV1::model::ListStreamSource; use datadog_api_client::datadogV1::model::ListStreamWidgetDefinition; use datadog_api_client::datadogV1::model::ListStreamWidgetDefinitionType; use datadog_api_client::datadogV1::model::ListStreamWidgetRequest; use datadog_api_client::datadogV1::model::Widget; use datadog_api_client::datadogV1::model::WidgetDefinition; #[tokio::main] async fn main() { // there is a valid "dashboard" in the system let dashboard_id = std::env::var("DASHBOARD_ID").unwrap(); let body = Dashboard::new( DashboardLayoutType::ORDERED, "Example-Dashboard with list_stream widget".to_string(), vec![Widget::new(WidgetDefinition::ListStreamWidgetDefinition( Box::new(ListStreamWidgetDefinition::new( vec![ListStreamWidgetRequest::new( vec![ListStreamColumn::new( "timestamp".to_string(), ListStreamColumnWidth::AUTO, )], ListStreamQuery::new(ListStreamSource::APM_ISSUE_STREAM, "".to_string()), ListStreamResponseFormat::EVENT_LIST, )], ListStreamWidgetDefinitionType::LIST_STREAM, )), ))], ) .description(Some("Updated description".to_string())) .tags(Some(vec!["team:foo".to_string(), "team:bar".to_string()])); let configuration = datadog::Configuration::new(); let api = DashboardsAPI::with_config(configuration); let resp = api.update_dashboard(dashboard_id.clone(), body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Update a dashboard returns "OK" response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.DashboardsApi(configuration); // there is a valid "dashboard" in the system const DASHBOARD_ID = process.env.DASHBOARD_ID as string; const params: v1.DashboardsApiUpdateDashboardRequest = { body: { layoutType: "ordered", title: "Example-Dashboard with list_stream widget", description: "Updated description", widgets: [ { definition: { type: "list_stream", requests: [ { columns: [ { width: "auto", field: "timestamp", }, ], query: { dataSource: "apm_issue_stream", queryString: "", }, responseFormat: "event_list", }, ], }, }, ], }, dashboardId: DASHBOARD_ID, }; apiInstance .updateDashboard(params) .then((data: v1.Dashboard) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` ##### ```typescript /** * Update a dashboard with tags returns "OK" response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.DashboardsApi(configuration); // there is a valid "dashboard" in the system const DASHBOARD_ID = process.env.DASHBOARD_ID as string; const params: v1.DashboardsApiUpdateDashboardRequest = { body: { layoutType: "ordered", title: "Example-Dashboard with list_stream widget", description: "Updated description", tags: ["team:foo", "team:bar"], widgets: [ { definition: { type: "list_stream", requests: [ { columns: [ { width: "auto", field: "timestamp", }, ], query: { dataSource: "apm_issue_stream", queryString: "", }, responseFormat: "event_list", }, ], }, }, ], }, dashboardId: DASHBOARD_ID, }; apiInstance .updateDashboard(params) .then((data: v1.Dashboard) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}