@@ -2599,6 +2599,14 @@ components:
2599
2599
required :
2600
2600
- data
2601
2601
type : object
2602
+ IntakePayloadAccepted :
2603
+ description : The payload accepted for intake.
2604
+ properties :
2605
+ status :
2606
+ description : The status of the intake payload.
2607
+ example : ok
2608
+ type : string
2609
+ type : object
2602
2610
ListApplicationKeysResponse :
2603
2611
description : Response for a list of application keys.
2604
2612
properties :
@@ -3877,6 +3885,14 @@ components:
3877
3885
pattern : ^[A-Za-z][A-Za-z0-9\.\-\_:\/]*$
3878
3886
type : string
3879
3887
type : array
3888
+ MetricContentEncoding :
3889
+ default : deflate
3890
+ description : HTTP header used to compress the media-type.
3891
+ enum :
3892
+ - deflate
3893
+ type : string
3894
+ x-enum-varnames :
3895
+ - DEFLATE
3880
3896
MetricCustomAggregation :
3881
3897
description : A time and space aggregation combination for use in query.
3882
3898
example :
@@ -4081,10 +4097,151 @@ components:
4081
4097
type : string
4082
4098
x-enum-varnames :
4083
4099
- METRIC_VOLUMES
4100
+ MetricIntakeType :
4101
+ description : The type of metric.
4102
+ enum :
4103
+ - 0
4104
+ - 1
4105
+ - 2
4106
+ - 3
4107
+ - 15
4108
+ format : int32
4109
+ type : integer
4110
+ x-enum-varnames :
4111
+ - UNSPECIFIED
4112
+ - COUNT
4113
+ - RATE
4114
+ - GAUGE
4115
+ - UNSPECIFIED_LEGACY
4116
+ MetricMetadata :
4117
+ description : Metadata for the metric.
4118
+ properties :
4119
+ origin :
4120
+ $ref : ' #/components/schemas/MetricOrigin'
4121
+ type : object
4084
4122
MetricName :
4085
4123
description : The metric name for this resource.
4086
4124
example : test.metric.latency
4087
4125
type : string
4126
+ MetricOrigin :
4127
+ description : Metric origin information.
4128
+ properties :
4129
+ metric_type :
4130
+ default : 0
4131
+ description : The origin metric type code
4132
+ format : int32
4133
+ maximum : 1000
4134
+ type : integer
4135
+ product :
4136
+ default : 0
4137
+ description : The origin product code
4138
+ format : int32
4139
+ maximum : 1000
4140
+ type : integer
4141
+ service :
4142
+ default : 0
4143
+ description : The origin service code
4144
+ format : int32
4145
+ maximum : 1000
4146
+ type : integer
4147
+ type : object
4148
+ MetricPayload :
4149
+ description : The metrics' payload.
4150
+ properties :
4151
+ series :
4152
+ description : A list of time series to submit to Datadog.
4153
+ example :
4154
+ - metric : system.load.1
4155
+ points :
4156
+ - timestamp : 1475317847
4157
+ value : 0.7
4158
+ items :
4159
+ $ref : ' #/components/schemas/MetricSeries'
4160
+ type : array
4161
+ required :
4162
+ - series
4163
+ type : object
4164
+ MetricPoint :
4165
+ description : A point object is of the form `{POSIX_timestamp, numeric_value}`.
4166
+ example :
4167
+ timestamp : 1575317847
4168
+ value : 0.5
4169
+ properties :
4170
+ timestamp :
4171
+ description : ' The timestamp should be in seconds and current.
4172
+
4173
+ Current is defined as not more than 10 minutes in the future or more than
4174
+ 1 hour in the past.'
4175
+ format : int64
4176
+ type : integer
4177
+ value :
4178
+ description : The numeric value format should be a 64bit float gauge-type
4179
+ value.
4180
+ format : double
4181
+ type : number
4182
+ type : object
4183
+ MetricResource :
4184
+ description : Metric resource.
4185
+ properties :
4186
+ name :
4187
+ description : The name of the metric.
4188
+ type : string
4189
+ type :
4190
+ description : The type of metric.
4191
+ type : string
4192
+ type : object
4193
+ MetricSeries :
4194
+ description : ' A metric to submit to Datadog.
4195
+
4196
+ See [Datadog metrics](https://docs.datadoghq.com/developers/metrics/#custom-metrics-properties).'
4197
+ properties :
4198
+ interval :
4199
+ description : If the type of the metric is rate or count, define the corresponding
4200
+ interval.
4201
+ example : 20
4202
+ format : int64
4203
+ type : integer
4204
+ metadata :
4205
+ $ref : ' #/components/schemas/MetricMetadata'
4206
+ metric :
4207
+ description : The name of the timeseries.
4208
+ example : system.load.1
4209
+ type : string
4210
+ points :
4211
+ description : Points relating to a metric. All points must be objects with
4212
+ timestamp and a scalar value (cannot be a string). Timestamps should be
4213
+ in POSIX time in seconds, and cannot be more than ten minutes in the future
4214
+ or more than one hour in the past.
4215
+ items :
4216
+ $ref : ' #/components/schemas/MetricPoint'
4217
+ type : array
4218
+ resources :
4219
+ description : A list of resources to associate with this metric.
4220
+ items :
4221
+ $ref : ' #/components/schemas/MetricResource'
4222
+ type : array
4223
+ source_type_name :
4224
+ description : The source type name.
4225
+ example : datadog
4226
+ type : string
4227
+ tags :
4228
+ description : A list of tags associated with the metric.
4229
+ example :
4230
+ - environment:test
4231
+ items :
4232
+ description : Individual tags.
4233
+ type : string
4234
+ type : array
4235
+ type :
4236
+ $ref : ' #/components/schemas/MetricIntakeType'
4237
+ unit :
4238
+ description : The unit of point value.
4239
+ example : second
4240
+ type : string
4241
+ required :
4242
+ - metric
4243
+ - points
4244
+ type : object
4088
4245
MetricTagConfiguration :
4089
4246
description : Object for a single metric tag configuration.
4090
4247
example :
@@ -11595,6 +11752,80 @@ paths:
11595
11752
x-unstable : ' **Note**: This endpoint is in public beta.
11596
11753
11597
11754
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
11755
+ /api/v2/series :
11756
+ post :
11757
+ description : " The metrics end-point allows you to post time-series data that
11758
+ can be graphed on Datadog\u2019 s dashboards.\n The maximum payload size is
11759
+ 500 kilobytes (512000 bytes). Compressed payloads must have a decompressed
11760
+ size of less than 5 megabytes (5242880 bytes).\n\n If you\u2019 re submitting
11761
+ metrics directly to the Datadog API without using DogStatsD, expect:\n\n -
11762
+ 64 bits for the timestamp\n - 64 bits for the value\n - 20 bytes for the metric
11763
+ names\n - 50 bytes for the timeseries\n - The full payload is approximately
11764
+ 100 bytes."
11765
+ operationId : SubmitMetrics
11766
+ parameters :
11767
+ - description : HTTP header used to compress the media-type.
11768
+ in : header
11769
+ name : Content-Encoding
11770
+ required : false
11771
+ schema :
11772
+ $ref : ' #/components/schemas/MetricContentEncoding'
11773
+ requestBody :
11774
+ content :
11775
+ application/json :
11776
+ examples :
11777
+ dynamic-points :
11778
+ description : " Post time-series data that can be graphed on Datadog\u2019 s
11779
+ dashboards."
11780
+ externalValue : examples/metrics/dynamic-points.json.sh
11781
+ summary : Dynamic Points
11782
+ x-variables :
11783
+ NOW : $(date +%s)
11784
+ schema :
11785
+ $ref : ' #/components/schemas/MetricPayload'
11786
+ required : true
11787
+ responses :
11788
+ ' 202 ' :
11789
+ content :
11790
+ application/json :
11791
+ schema :
11792
+ $ref : ' #/components/schemas/IntakePayloadAccepted'
11793
+ description : Payload accepted
11794
+ ' 400 ' :
11795
+ content :
11796
+ application/json :
11797
+ schema :
11798
+ $ref : ' #/components/schemas/APIErrorResponse'
11799
+ description : Bad Request
11800
+ ' 403 ' :
11801
+ content :
11802
+ application/json :
11803
+ schema :
11804
+ $ref : ' #/components/schemas/APIErrorResponse'
11805
+ description : Authentication error
11806
+ ' 408 ' :
11807
+ content :
11808
+ application/json :
11809
+ schema :
11810
+ $ref : ' #/components/schemas/APIErrorResponse'
11811
+ description : Request timeout
11812
+ ' 413 ' :
11813
+ content :
11814
+ application/json :
11815
+ schema :
11816
+ $ref : ' #/components/schemas/APIErrorResponse'
11817
+ description : Payload too large
11818
+ ' 429 ' :
11819
+ $ref : ' #/components/responses/TooManyRequestsResponse'
11820
+ security :
11821
+ - apiKeyAuth : []
11822
+ summary : Submit metrics
11823
+ tags :
11824
+ - Metrics
11825
+ x-codegen-request-body-name : body
11826
+ x-menu-order : 1
11827
+ x-undo :
11828
+ type : safe
11598
11829
/api/v2/service_accounts :
11599
11830
post :
11600
11831
description : Create a service account for your organization.
0 commit comments