{
"dataset": {
"name": "<string>",
"configuration": {
"log_dataset": {
"match_criteria": {
"query": "<string>"
}
},
"trace_dataset": {
"match_criteria": {
"scope_filter": {
"span_scopes": [
{
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
},
"is_root_span": {
"value": true
},
"match_type": "INCLUDE",
"operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"span_count": {
"max": 123,
"min": 123
},
"tags": [
{
"key": "<string>",
"numeric_value": {
"comparison": "EQUAL",
"value": 123
},
"value": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
}
}
]
}
]
},
"span": [
{
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
},
"is_root_span": {
"value": true
},
"match_type": "INCLUDE",
"operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"span_count": {
"max": 123,
"min": 123
},
"tags": [
{
"key": "<string>",
"numeric_value": {
"comparison": "EQUAL",
"value": 123
},
"value": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
}
}
]
}
],
"trace": {
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
}
}
}
},
"type": "TRACES"
},
"created_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"slug": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
}{
"dataset": {
"name": "<string>",
"configuration": {
"log_dataset": {
"match_criteria": {
"query": "<string>"
}
},
"trace_dataset": {
"match_criteria": {
"scope_filter": {
"span_scopes": [
{
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
},
"is_root_span": {
"value": true
},
"match_type": "INCLUDE",
"operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"span_count": {
"max": 123,
"min": 123
},
"tags": [
{
"key": "<string>",
"numeric_value": {
"comparison": "EQUAL",
"value": 123
},
"value": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
}
}
]
}
]
},
"span": [
{
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
},
"is_root_span": {
"value": true
},
"match_type": "INCLUDE",
"operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_operation": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"parent_service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"service": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
},
"span_count": {
"max": 123,
"min": 123
},
"tags": [
{
"key": "<string>",
"numeric_value": {
"comparison": "EQUAL",
"value": 123
},
"value": {
"in_values": [
"<string>"
],
"match": "EXACT",
"value": "<string>"
}
}
]
}
],
"trace": {
"duration": {
"max_secs": 123,
"min_secs": 123
},
"error": {
"value": true
}
}
}
},
"type": "TRACES"
},
"created_at": "2023-11-07T05:31:56Z",
"description": "<string>",
"slug": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
}Authorizations
Chronosphere API token
Path Parameters
Body
If true, the Dataset will be created if it does not already exist, identified by slug. If false, an error will be returned if the Dataset does not already exist.
The Dataset to update.
Show child attributes
Show child attributes
The name of the Dataset. You can modify this value after the Dataset is created.
Required. Defines the configuration of the dataset.
Show child attributes
Show child attributes
If the dataset type is LOGS, this configuration defines the semantics for
the log dataset.
Show child attributes
Show child attributes
Required. Defines the criteria to match logs to a dataset.
Show child attributes
Show child attributes
Returns logs that match this query. The query can include only top-level
operations. Nested clauses aren't supported. Only one type of AND or OR
operator is allowed.
If the dataset type is TRACES, this configuration defines the semantics for
the trace dataset.
Show child attributes
Show child attributes
Required. Defines the criteria to match traces to a dataset.
Show child attributes
Show child attributes
Scope filter that defines which spans within matching traces contribute to metrics calculation.
Show child attributes
Show child attributes
Specifies the span filters that define which spans contribute to the metrics calculation. Only spans matching these filters will be included in the metrics aggregation.
Show child attributes
Show child attributes
Matches the duration of the candidate span.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
Matches the error status of the candidate span.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
Matches the root span of a trace. For example, if the parent span has no child spans.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
If INCLUDE, includes all traces that have at least one (or span_count)
spans matching the query. If EXCLUDE, excludes all traces that have at least
one (or span_count) spans matching the query.
INCLUDE, EXCLUDE Matches the operation of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the operation of the candidate span's parent span
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the service of the candidate span's parent span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Matches the service of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Defines the number of spans that must match the criteria defined by the span query. Defaults to requiring that at least one span matches the span query.
Show child attributes
Show child attributes
Maximum number of spans that must match a span query, inclusive.
Minimum number of spans that must match a span query, inclusive.
Matches the tags of the candidate span.
Show child attributes
Show child attributes
The key or name of the span tag that this filter inspects.
If the query matches the tag with the specified key, and the value type is
numeric, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
The comparison operation to apply to an input against the given query value.
EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL The filter value used in comparison against match candidates.
If the query matches the tag with the specified key, and the value type is a
string, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Specifies the span conditions to match on. All conditions must be true in a
single span for the span to be considered a match. If span_count is specified,
the number of spans within the trace that match span conditions must be within
[min, max]. You can specify multiple span conditions, and each can be
satisfied by any number of spans within the trace.
Show child attributes
Show child attributes
Matches the duration of the candidate span.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
Matches the root span of a trace. For example, if the parent span has no child spans.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
If INCLUDE, includes all traces that have at least one (or span_count)
spans matching the query. If EXCLUDE, excludes all traces that have at least
one (or span_count) spans matching the query.
INCLUDE, EXCLUDE Matches the operation of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the operation of the candidate span's parent span
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the service of the candidate span's parent span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Matches the service of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Defines the number of spans that must match the criteria defined by the span query. Defaults to requiring that at least one span matches the span query.
Show child attributes
Show child attributes
Matches the tags of the candidate span.
Show child attributes
Show child attributes
The key or name of the span tag that this filter inspects.
If the query matches the tag with the specified key, and the value type is
numeric, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
The comparison operation to apply to an input against the given query value.
EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL The filter value used in comparison against match candidates.
If the query matches the tag with the specified key, and the value type is a
string, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Trace-level filter criteria (effectively matching the root span).
Show child attributes
Show child attributes
Matches traces based on the duration of the entire trace.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
The type of dataset.
TRACES, LOGS Required. Description of the dataset.
The unique identifier of the Dataset. If a slug isn't provided, one is generated based on the name field. You can't modify this field after the Dataset is created.
If true, validates the specified configuration without creating or updating the Dataset. If the specified configuration is valid, the endpoint returns a partial response without the Dataset. If the specified configuration is invalid, the endpoint returns an error.
Response
A successful response containing the updated Dataset.
Show child attributes
Show child attributes
The name of the Dataset. You can modify this value after the Dataset is created.
Required. Defines the configuration of the dataset.
Show child attributes
Show child attributes
If the dataset type is LOGS, this configuration defines the semantics for
the log dataset.
Show child attributes
Show child attributes
Required. Defines the criteria to match logs to a dataset.
Show child attributes
Show child attributes
Returns logs that match this query. The query can include only top-level
operations. Nested clauses aren't supported. Only one type of AND or OR
operator is allowed.
If the dataset type is TRACES, this configuration defines the semantics for
the trace dataset.
Show child attributes
Show child attributes
Required. Defines the criteria to match traces to a dataset.
Show child attributes
Show child attributes
Scope filter that defines which spans within matching traces contribute to metrics calculation.
Show child attributes
Show child attributes
Specifies the span filters that define which spans contribute to the metrics calculation. Only spans matching these filters will be included in the metrics aggregation.
Show child attributes
Show child attributes
Matches the duration of the candidate span.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
Matches the error status of the candidate span.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
Matches the root span of a trace. For example, if the parent span has no child spans.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
If INCLUDE, includes all traces that have at least one (or span_count)
spans matching the query. If EXCLUDE, excludes all traces that have at least
one (or span_count) spans matching the query.
INCLUDE, EXCLUDE Matches the operation of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the operation of the candidate span's parent span
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the service of the candidate span's parent span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Matches the service of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Defines the number of spans that must match the criteria defined by the span query. Defaults to requiring that at least one span matches the span query.
Show child attributes
Show child attributes
Maximum number of spans that must match a span query, inclusive.
Minimum number of spans that must match a span query, inclusive.
Matches the tags of the candidate span.
Show child attributes
Show child attributes
The key or name of the span tag that this filter inspects.
If the query matches the tag with the specified key, and the value type is
numeric, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
The comparison operation to apply to an input against the given query value.
EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL The filter value used in comparison against match candidates.
If the query matches the tag with the specified key, and the value type is a
string, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Specifies the span conditions to match on. All conditions must be true in a
single span for the span to be considered a match. If span_count is specified,
the number of spans within the trace that match span conditions must be within
[min, max]. You can specify multiple span conditions, and each can be
satisfied by any number of spans within the trace.
Show child attributes
Show child attributes
Matches the duration of the candidate span.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
Matches the root span of a trace. For example, if the parent span has no child spans.
Show child attributes
Show child attributes
The value of the filter compared to the target trace or span field.
If INCLUDE, includes all traces that have at least one (or span_count)
spans matching the query. If EXCLUDE, excludes all traces that have at least
one (or span_count) spans matching the query.
INCLUDE, EXCLUDE Matches the operation of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the operation of the candidate span's parent span
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
If not a root span, matches the service of the candidate span's parent span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Matches the service of the candidate span.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Defines the number of spans that must match the criteria defined by the span query. Defaults to requiring that at least one span matches the span query.
Show child attributes
Show child attributes
Matches the tags of the candidate span.
Show child attributes
Show child attributes
The key or name of the span tag that this filter inspects.
If the query matches the tag with the specified key, and the value type is
numeric, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
The comparison operation to apply to an input against the given query value.
EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL The filter value used in comparison against match candidates.
If the query matches the tag with the specified key, and the value type is a
string, specifies the matcher used to evaluate the span tag value.
Show child attributes
Show child attributes
Values the filter tests against when using IN or NOT_IN match type.
Specifies the comparison operator for the query. If EXACT, compared strings
must have the exact value of the query value.
EXACT, REGEX, EXACT_NEGATION, REGEX_NEGATION, IN, NOT_IN The value of the filter compared to the target trace or span field.
Trace-level filter criteria (effectively matching the root span).
Show child attributes
Show child attributes
Matches traces based on the duration of the entire trace.
Show child attributes
Show child attributes
Maximum duration, in seconds, required for a span or trace to match.
Minimum duration, in seconds, required for a span or trace to match.
The type of dataset.
TRACES, LOGS Timestamp of when the Dataset was created. Cannot be set by clients.
Required. Description of the dataset.
The unique identifier of the Dataset. If a slug isn't provided, one is generated based on the name field. You can't modify this field after the Dataset is created.
Timestamp of when the Dataset was last updated. Cannot be set by clients.