@@ -92039,111 +92039,92 @@ paths:
9203992039 - logs_read_data
9204092040 /api/v2/metrics:
9204192041 get:
92042- description: 'Returns all metrics for your organization that match the given
92043- filter parameters.
92044-
92045- Optionally, paginate by using the `page[cursor]` and/or `page[size]` query
92046- parameters.
92047-
92048- To fetch the first page, pass in a query parameter with either a valid `page[size]`
92049- or an empty cursor like `page[cursor]=`. To fetch the next page, pass in the
92050- `next_cursor` value from the response as the new `page[cursor]` value.
92051-
92052- Once the `meta.pagination.next_cursor` value is null, all pages have been
92053- retrieved.'
92042+ description: Get a list of actively reporting metrics for your organization.
92043+ Pagination is optional using the `page[cursor]` and `page[size]` query parameters.
9205492044 operationId: ListTagConfigurations
9205592045 parameters:
92056- - description: Filter custom metrics that have configured tags.
92046+ - description: Only return custom metrics that have been configured with Metrics
92047+ Without Limits.
9205792048 example: true
9205892049 in: query
9205992050 name: filter[configured]
9206092051 required: false
9206192052 schema:
9206292053 type: boolean
92063- - description: Filter tag configurations by configured tags.
92064- example: app
92054+ - description: Only return metrics that have the given tag key(s) in their Metrics
92055+ Without Limits configuration (included or excluded).
92056+ example: app,env
9206592057 in: query
9206692058 name: filter[tags_configured]
9206792059 required: false
9206892060 schema:
9206992061 description: Tag keys to filter by.
9207092062 type: string
92071- - description: Filter metrics by metric type.
92063+ - description: Only return metrics of the given metric type.
9207292064 in: query
9207392065 name: filter[metric_type]
9207492066 required: false
9207592067 schema:
9207692068 $ref: '#/components/schemas/MetricTagConfigurationMetricTypeCategory'
92077- - description: 'Filter distributions with additional percentile
92078-
92079- aggregations enabled or disabled.'
92069+ - description: Only return distribution metrics that have percentile aggregations
92070+ enabled (true) or disabled (false).
9208092071 example: true
9208192072 in: query
9208292073 name: filter[include_percentiles]
9208392074 required: false
9208492075 schema:
9208592076 type: boolean
92086- - description: '(Preview) Filter custom metrics that have or have not been queried
92087- in the specified window[seconds].
92088-
92089- If no window is provided or the window is less than 2 hours, a default of
92090- 2 hours will be applied.'
92077+ - description: Only return metrics that have been queried (true) or not queried
92078+ (false) in the look back window. Set the window with `filter[queried][window][seconds]`;
92079+ if omitted, a default window is used.
9209192080 example: true
9209292081 in: query
9209392082 name: filter[queried]
9209492083 required: false
9209592084 schema:
9209692085 type: boolean
92097- - description: 'The number of seconds of look back (from now) used by the `filter[queried]`
92098- filter logic.
92099-
92100- Must be sent with `filter[queried]` and is only applied when `filter[queried]=true`.
92101-
92102- If `filter[queried]=false`, this parameter is ignored and default queried-window
92103- behavior applies.
92104-
92105- If `filter[queried]` is not provided, sending this parameter returns a 400.
92106-
92107- For example: `GET /api/v2/metrics?filter[queried]=true&filter[queried][window][seconds]=15552000`.'
92086+ - description: Only return metrics that have been queried or not queried in
92087+ the specified window. Dependent on being sent with `filter[queried]`.
9210892088 example: 15552000
9210992089 in: query
9211092090 name: filter[queried][window][seconds]
9211192091 required: false
9211292092 schema:
92093+ default: 2592000
9211392094 format: int64
9211492095 maximum: 15552000
92115- minimum: 0
92096+ minimum: 1
9211692097 type: integer
92117- - description: 'Filter metrics that have been submitted with the given tags.
92118- Supports boolean and wildcard expressions.
92119-
92120- Can only be combined with the filter[queried] filter.'
92121- example: env IN (staging,test) AND service:web
92098+ - description: Only return metrics that were submitted with tags matching this
92099+ expression. You can use AND, OR, IN, and wildcards (for example, service:web*).
92100+ example: env IN (staging,test) AND service:web*
9212292101 in: query
9212392102 name: filter[tags]
9212492103 required: false
9212592104 schema:
9212692105 type: string
92127- - description: (Preview) Filter metrics that are used in dashboards, monitors ,
92128- notebooks, SLOs .
92106+ - description: Only return metrics that are used in at least one dashboard ,
92107+ monitor, notebook, or SLO .
9212992108 example: true
9213092109 in: query
9213192110 name: filter[related_assets]
9213292111 required: false
9213392112 schema:
9213492113 type: boolean
92135- - description: 'The number of seconds of look back (from now) to apply to a
92136- filter[tag] query.
92137-
92138- Default value is 3600 (1 hour), maximum value is 5,184,000 (60 days).'
92114+ - description: Only return metrics that have been actively reporting in the
92115+ specified window.
9213992116 example: 3600
9214092117 in: query
9214192118 name: window[seconds]
9214292119 required: false
9214392120 schema:
92121+ default: 3600
9214492122 format: int64
92123+ maximum: 2592000
92124+ minimum: 1
9214592125 type: integer
92146- - description: Maximum number of results returned.
92126+ - description: Maximum number of results per page. Use with `page[cursor]` for
92127+ pagination.
9214792128 in: query
9214892129 name: page[size]
9214992130 required: false
@@ -92153,12 +92134,9 @@ paths:
9215392134 maximum: 10000
9215492135 minimum: 1
9215592136 type: integer
92156- - description: 'String to query the next page of results.
92157-
92158- This key is provided with each valid response from the API in `meta.pagination.next_cursor`.
92159-
92160- Once the `meta.pagination.next_cursor` key is null, all pages have been
92161- retrieved.'
92137+ - description: Cursor for pagination. Use `page[size]` to opt-in to pagination
92138+ and get the first page; for subsequent pages, use the value from `meta.pagination.next_cursor`
92139+ in the response. Pagination is complete when `next_cursor` is null.
9216292140 in: query
9216392141 name: page[cursor]
9216492142 required: false
0 commit comments