{
"trace_tail_sampling_rules": {
"created_at": "2023-11-07T05:31:56Z",
"default_sample_rate": {
"enabled": true,
"sample_rate": 123
},
"rules": [
{
"created_at": "2023-11-07T05:31:56Z",
"filter": {
"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
}
}
},
"name": "<string>",
"sample_rate": 123,
"system_name": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"updated_at": "2023-11-07T05:31:56Z"
}
}ReadTraceTailSamplingRules
{
"trace_tail_sampling_rules": {
"created_at": "2023-11-07T05:31:56Z",
"default_sample_rate": {
"enabled": true,
"sample_rate": 123
},
"rules": [
{
"created_at": "2023-11-07T05:31:56Z",
"filter": {
"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
}
}
},
"name": "<string>",
"sample_rate": 123,
"system_name": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"updated_at": "2023-11-07T05:31:56Z"
}
}Authorizations
Chronosphere API token
Response
A successful response.
Root object containing all tail sampling rules (for a tenant).
Show child attributes
Show child attributes
Timestamp of when the rule was created.
Optional. By default, all traces not matching the defined rules are kept. You can override this behavior by providing a default sample rate.
Show child attributes
Show child attributes
Determines whether to override the default sample rate.
Specifies the percentage of traces to keep, which must be a number between 0
and 1, inclusive, where 1 equates to 100 percent.
Optional. Specifies a list of rules and a sampling rate to apply. Rules are evaluated in order until a match is found. If no sample rate is specified, the default sample rate is applied.
Show child attributes
Show child attributes
Timestamp of when the rule was created.
Filter criteria applied to each trace to determine whether the trace is a match.
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 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
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.
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
A human-readable name of the rule.
Specifies the percentage of traces to keep, which must be a number between 0
and 1, inclusive, where 1 equates to 100 percent.
Name used as the metric label value for metrics that are emitted from this rule.
Timestamp of when the rule was updated.
Timestamp of when the rule was updated.