Skip to content

Commit c6150bb

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit ec57a65 of spec repo
1 parent 0004175 commit c6150bb

17 files changed

+615
-11
lines changed

‎.generator/schemas/v1/openapi.yaml‎

Lines changed: 84 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1741,6 +1741,9 @@ components:
17411741
type: string
17421742
markers:
17431743
description: List of markers.
1744+
example:
1745+
- display_type: percentile
1746+
value: '90'
17441747
items:
17451748
$ref: '#/components/schemas/WidgetMarker'
17461749
type: array
@@ -1816,6 +1819,11 @@ components:
18161819
$ref: '#/components/schemas/ApmStatsQueryDefinition'
18171820
event_query:
18181821
$ref: '#/components/schemas/LogQueryDefinition'
1822+
formulas:
1823+
description: List of formulas that operate on queries.
1824+
items:
1825+
$ref: '#/components/schemas/WidgetFormula'
1826+
type: array
18191827
log_query:
18201828
$ref: '#/components/schemas/LogQueryDefinition'
18211829
network_query:
@@ -1827,10 +1835,17 @@ components:
18271835
q:
18281836
description: Widget query.
18291837
type: string
1838+
queries:
1839+
description: List of queries that can be returned directly or used in formulas.
1840+
items:
1841+
$ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
1842+
type: array
18301843
query:
18311844
$ref: '#/components/schemas/DistributionWidgetHistogramRequestQuery'
18321845
request_type:
18331846
$ref: '#/components/schemas/DistributionWidgetHistogramRequestType'
1847+
response_format:
1848+
$ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
18341849
rum_query:
18351850
$ref: '#/components/schemas/LogQueryDefinition'
18361851
security_query:
@@ -1854,6 +1869,12 @@ components:
18541869
description: Specifies minimum value to show on the x-axis. It takes a number,
18551870
percentile (p90 === 90th percentile), or auto for default behavior.
18561871
type: string
1872+
num_buckets:
1873+
description: Number of value buckets to target, aka the resolution of the
1874+
value bins.
1875+
example: 100
1876+
format: int64
1877+
type: integer
18571878
scale:
18581879
default: linear
18591880
description: Specifies the scale type. Possible values are `linear`.
@@ -3714,6 +3735,14 @@ components:
37143735
type: array
37153736
legend_size:
37163737
$ref: '#/components/schemas/WidgetLegendSize'
3738+
markers:
3739+
description: List of markers.
3740+
example:
3741+
- display_type: percentile
3742+
value: '90'
3743+
items:
3744+
$ref: '#/components/schemas/WidgetMarker'
3745+
type: array
37173746
requests:
37183747
description: List of widget types.
37193748
example:
@@ -3738,8 +3767,10 @@ components:
37383767
type: string
37393768
type:
37403769
$ref: '#/components/schemas/HeatMapWidgetDefinitionType'
3770+
xaxis:
3771+
$ref: '#/components/schemas/HeatMapWidgetXAxis'
37413772
yaxis:
3742-
$ref: '#/components/schemas/WidgetAxis'
3773+
$ref: '#/components/schemas/HeatMapWidgetYAxis'
37433774
required:
37443775
- type
37453776
- requests
@@ -3781,6 +3812,10 @@ components:
37813812
items:
37823813
$ref: '#/components/schemas/FormulaAndFunctionQueryDefinition'
37833814
type: array
3815+
query:
3816+
$ref: '#/components/schemas/DistributionWidgetHistogramRequestQuery'
3817+
request_type:
3818+
$ref: '#/components/schemas/DistributionWidgetHistogramRequestType'
37843819
response_format:
37853820
$ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
37863821
rum_query:
@@ -3790,6 +3825,49 @@ components:
37903825
style:
37913826
$ref: '#/components/schemas/WidgetStyle'
37923827
type: object
3828+
HeatMapWidgetXAxis:
3829+
description: X Axis controls for the heat map widget.
3830+
properties:
3831+
num_buckets:
3832+
description: Number of time buckets to target, aka the resolution of the
3833+
time bins. This is only applicable for distribution of points (group distributions
3834+
use the roll-up modifier).
3835+
example: 50
3836+
format: int64
3837+
type: integer
3838+
type: object
3839+
HeatMapWidgetYAxis:
3840+
description: Y Axis controls for the heat map widget.
3841+
properties:
3842+
include_zero:
3843+
description: Set to `true` to include zero.
3844+
type: boolean
3845+
label:
3846+
description: The label of the axis to display on the graph. Only usable
3847+
on Scatterplot Widgets.
3848+
type: string
3849+
max:
3850+
default: auto
3851+
description: Specifies maximum numeric value to show on the axis. Defaults
3852+
to `auto`.
3853+
type: string
3854+
min:
3855+
default: auto
3856+
description: Specifies minimum numeric value to show on the axis. Defaults
3857+
to `auto`.
3858+
type: string
3859+
num_buckets:
3860+
description: Number of value buckets to target, aka the resolution of the
3861+
value bins.
3862+
example: 50
3863+
format: int64
3864+
type: integer
3865+
scale:
3866+
default: linear
3867+
description: Specifies the scale type. Possible values are `linear`, `log`,
3868+
`sqrt`, and `pow##` (for example `pow2` or `pow0.5`).
3869+
type: string
3870+
type: object
37933871
Host:
37943872
description: Object representing a host.
37953873
properties:
@@ -25147,7 +25225,7 @@ components:
2514725225
display_type:
2514825226
description: "Combination of:\n - A severity error, warning, ok, or info\n
2514925227
\ - A line type: dashed, solid, or bold\nIn this case of a Distribution
25150-
widget, this can be set to be `x_axis_percentile`."
25228+
widget, this can be set to be `percentile`."
2515125229
example: error dashed
2515225230
type: string
2515325231
label:
@@ -25158,8 +25236,11 @@ components:
2515825236
description: Timestamp for the widget.
2515925237
type: string
2516025238
value:
25161-
description: Value to apply. Can be a single value y = 15 or a range of
25239+
description: 'Value to apply. Can be a single value y = 15 or a range of
2516225240
values 0 < y < 10.
25241+
25242+
For Distribution widgets with `display_type` set to `percentile`, this
25243+
should be a numeric percentile value (e.g., "90" for P90).'
2516325244
example: y = 15
2516425245
type: string
2516525246
required:

‎docs/datadog_api_client.v1.model.rst‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1138,6 +1138,20 @@ datadog\_api\_client.v1.model.heat\_map\_widget\_request module
11381138
:members:
11391139
:show-inheritance:
11401140

1141+
datadog\_api\_client.v1.model.heat\_map\_widget\_x\_axis module
1142+
---------------------------------------------------------------
1143+
1144+
.. automodule:: datadog_api_client.v1.model.heat_map_widget_x_axis
1145+
:members:
1146+
:show-inheritance:
1147+
1148+
datadog\_api\_client.v1.model.heat\_map\_widget\_y\_axis module
1149+
---------------------------------------------------------------
1150+
1151+
.. automodule:: datadog_api_client.v1.model.heat_map_widget_y_axis
1152+
:members:
1153+
:show-inheritance:
1154+
11411155
datadog\_api\_client.v1.model.host module
11421156
-----------------------------------------
11431157

‎examples/v1/dashboards/CreateDashboard_1093147852.py‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
"""
2+
Create a new dashboard with distribution widget with markers and num_buckets
3+
"""
4+
5+
from datadog_api_client import ApiClient, Configuration
6+
from datadog_api_client.v1.api.dashboards_api import DashboardsApi
7+
from datadog_api_client.v1.model.dashboard import Dashboard
8+
from datadog_api_client.v1.model.dashboard_layout_type import DashboardLayoutType
9+
from datadog_api_client.v1.model.distribution_widget_definition import DistributionWidgetDefinition
10+
from datadog_api_client.v1.model.distribution_widget_definition_type import DistributionWidgetDefinitionType
11+
from datadog_api_client.v1.model.distribution_widget_request import DistributionWidgetRequest
12+
from datadog_api_client.v1.model.distribution_widget_x_axis import DistributionWidgetXAxis
13+
from datadog_api_client.v1.model.distribution_widget_y_axis import DistributionWidgetYAxis
14+
from datadog_api_client.v1.model.formula_and_function_metric_aggregation import FormulaAndFunctionMetricAggregation
15+
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
16+
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
17+
FormulaAndFunctionMetricQueryDefinition,
18+
)
19+
from datadog_api_client.v1.model.formula_and_function_response_format import FormulaAndFunctionResponseFormat
20+
from datadog_api_client.v1.model.widget import Widget
21+
from datadog_api_client.v1.model.widget_layout import WidgetLayout
22+
from datadog_api_client.v1.model.widget_marker import WidgetMarker
23+
from datadog_api_client.v1.model.widget_text_align import WidgetTextAlign
24+
25+
body = Dashboard(
26+
title="Example-Dashboard",
27+
widgets=[
28+
Widget(
29+
definition=DistributionWidgetDefinition(
30+
title="",
31+
title_size="16",
32+
title_align=WidgetTextAlign.LEFT,
33+
type=DistributionWidgetDefinitionType.DISTRIBUTION,
34+
xaxis=DistributionWidgetXAxis(
35+
scale="linear",
36+
min="auto",
37+
max="auto",
38+
include_zero=True,
39+
num_buckets=55,
40+
),
41+
yaxis=DistributionWidgetYAxis(
42+
scale="linear",
43+
min="auto",
44+
max="auto",
45+
include_zero=True,
46+
),
47+
markers=[
48+
WidgetMarker(
49+
display_type="percentile",
50+
value="50",
51+
),
52+
WidgetMarker(
53+
display_type="percentile",
54+
value="99",
55+
),
56+
WidgetMarker(
57+
display_type="percentile",
58+
value="90",
59+
),
60+
],
61+
requests=[
62+
DistributionWidgetRequest(
63+
response_format=FormulaAndFunctionResponseFormat.SCALAR,
64+
queries=[
65+
FormulaAndFunctionMetricQueryDefinition(
66+
data_source=FormulaAndFunctionMetricDataSource.METRICS,
67+
name="query1",
68+
query="avg:system.cpu.user{*} by {service}",
69+
aggregator=FormulaAndFunctionMetricAggregation.AVG,
70+
),
71+
],
72+
),
73+
],
74+
),
75+
layout=WidgetLayout(
76+
x=0,
77+
y=0,
78+
width=4,
79+
height=4,
80+
),
81+
),
82+
],
83+
layout_type=DashboardLayoutType.ORDERED,
84+
)
85+
86+
configuration = Configuration()
87+
with ApiClient(configuration) as api_client:
88+
api_instance = DashboardsApi(api_client)
89+
response = api_instance.create_dashboard(body=body)
90+
91+
print(response)

‎examples/v1/dashboards/CreateDashboard_2823363212.py‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
"""
2+
Create a new dashboard with heatmap widget with markers and num_buckets
3+
"""
4+
5+
from datadog_api_client import ApiClient, Configuration
6+
from datadog_api_client.v1.api.dashboards_api import DashboardsApi
7+
from datadog_api_client.v1.model.dashboard import Dashboard
8+
from datadog_api_client.v1.model.dashboard_layout_type import DashboardLayoutType
9+
from datadog_api_client.v1.model.distribution_widget_histogram_request_type import (
10+
DistributionWidgetHistogramRequestType,
11+
)
12+
from datadog_api_client.v1.model.formula_and_function_metric_data_source import FormulaAndFunctionMetricDataSource
13+
from datadog_api_client.v1.model.formula_and_function_metric_query_definition import (
14+
FormulaAndFunctionMetricQueryDefinition,
15+
)
16+
from datadog_api_client.v1.model.heat_map_widget_definition import HeatMapWidgetDefinition
17+
from datadog_api_client.v1.model.heat_map_widget_definition_type import HeatMapWidgetDefinitionType
18+
from datadog_api_client.v1.model.heat_map_widget_request import HeatMapWidgetRequest
19+
from datadog_api_client.v1.model.heat_map_widget_x_axis import HeatMapWidgetXAxis
20+
from datadog_api_client.v1.model.heat_map_widget_y_axis import HeatMapWidgetYAxis
21+
from datadog_api_client.v1.model.widget import Widget
22+
from datadog_api_client.v1.model.widget_layout import WidgetLayout
23+
from datadog_api_client.v1.model.widget_marker import WidgetMarker
24+
from datadog_api_client.v1.model.widget_text_align import WidgetTextAlign
25+
26+
body = Dashboard(
27+
title="Example-Dashboard",
28+
widgets=[
29+
Widget(
30+
definition=HeatMapWidgetDefinition(
31+
title="",
32+
title_size="16",
33+
title_align=WidgetTextAlign.LEFT,
34+
type=HeatMapWidgetDefinitionType.HEATMAP,
35+
xaxis=HeatMapWidgetXAxis(
36+
num_buckets=75,
37+
),
38+
yaxis=HeatMapWidgetYAxis(
39+
scale="linear",
40+
min="auto",
41+
max="auto",
42+
include_zero=True,
43+
num_buckets=55,
44+
),
45+
markers=[
46+
WidgetMarker(
47+
display_type="percentile",
48+
value="50",
49+
),
50+
WidgetMarker(
51+
display_type="percentile",
52+
value="99",
53+
),
54+
],
55+
requests=[
56+
HeatMapWidgetRequest(
57+
request_type=DistributionWidgetHistogramRequestType.HISTOGRAM,
58+
query=FormulaAndFunctionMetricQueryDefinition(
59+
data_source=FormulaAndFunctionMetricDataSource.METRICS,
60+
name="query1",
61+
query="histogram:trace.servlet.request{*}",
62+
),
63+
),
64+
],
65+
),
66+
layout=WidgetLayout(
67+
x=0,
68+
y=0,
69+
width=4,
70+
height=4,
71+
),
72+
),
73+
],
74+
layout_type=DashboardLayoutType.ORDERED,
75+
)
76+
77+
configuration = Configuration()
78+
with ApiClient(configuration) as api_client:
79+
api_instance = DashboardsApi(api_client)
80+
response = api_instance.create_dashboard(body=body)
81+
82+
print(response)

0 commit comments

Comments
 (0)