Gets an OpenPipeline configuration in your Dynatrace environment for a given ID.
The request produces an application/json
payload.
GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/openpipeline/v1/configurations/{id} |
You can execute this request also with an OAuth2 client with openpipeline:configurations:read
permission.
To learn how to obtain and use it, see OAuth clients.
Identifier of the configuration.
Configuration
objectFull configuration containing ingest sources, pipelines and dynamic routing.
The base path for custom ingest endpoints.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Identifier of the configuration.
The update token of the configuration. You can use it to detect simultaneous modifications done by different users. It is generated upon retrieval (GET requests). If set on update (PUT request), the update will be allowed only if there wasn't any change between the retrieval and the update. If omitted on update, the operation overrides the current value without any checks.
The current version of the configuration.
EndpointDefinition
objectDefinition of a single ingest source.
The base path of the ingest source.
Indicates if the object is provided by Dynatrace or customer defined.
The default bucket assigned to records for the ingest source.
Display name of the ingest source.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
The segment of the ingest source, which is applied to the base path. Must be unique within a configuration.
EndpointProcessor
objectGroups all processors applicable for processing in the EndpointDefinition. Applicable processors are DqlProcessor, FieldsAddProcessor, FieldsRemoveProcessor, FieldsRenameProcessor, and DropProcessor.
Routing
objectRouting strategy, either dynamic or static.
Defines the actual set of fields depending on the value. See one of the following objects:
static
-> StaticRoutingdynamic
-> DynamicRoutingdynamic
static
PipelineDefinition
objectDefinition of a single pipeline, either 'default' or 'classic'.
Indicates if the object is provided by Dynatrace or customer defined.
Display name of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the pipeline.
Defines the actual set of fields depending on the value. See one of the following objects:
default
-> DefaultPipelineDefinitionclassic
-> ClassicPipelineDefinitionclassic
default
DataExtractionStage
objectData extraction stage configuration of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
DataExtractionStageProcessor
objectGroups all processors applicable for the DataExtractionStage. Applicable processors are DavisEventExtractionProcessor and BizeventExtractionProcessor.
MetricExtractionStage
objectMetric extraction stage configuration of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
MetricExtractionStageProcessor
objectGroups all processors applicable for the MetricExtractionStage. Applicable processors are CounterMetricExtractionProcessor and ValueMetricExtractionProcessor.
SecurityContextStage
objectSecurity context stage configuration of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
SecurityContextStageProcessor
objectGroups all processors applicable for the SecurityContextStage. Applicable processor is SecurityContextProcessor.
StorageStage
objectStorage stage configuration of the pipeline.
Default bucket assigned to records which do not match any other storage processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
StorageStageProcessor
objectGroups all processors applicable for the StorageStage. Applicable processors are BucketAssignmentProcessor and NoStorageProcessor.
RoutingTable
objectDynamic routing definition.
The default pipeline records are routed into if no dynamic routing entries apply.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
RoutingTableEntryTarget
objectThe default pipeline records are routed into if no dynamic routing entries apply.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Identifier of the pipeline.
RoutingTableEntry
objectDynamic routing entry.
Indicates if the object is provided by Dynatrace or customer defined.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Matching condition to apply on incoming records.
Unique note describing the dynamic route.
Identifier of the pipeline the record is routed into.
{"id": "events","editable": false,"version": "1719220519649-ff2897a62cf849b0baa95e71fa4d5f1f","updateToken": "NzgyMTVjYzAtOWYwNC0zZjQ1LWFmNzgtMWQ3OWZjNzdkYjMwX2E3YzZkN2QwLTdmMzctMTFlZi04MDAxLTAxMDAwMDAwMDAwMQ==","customBasePath": "/platform/ingest/custom/events","endpoints": [{"enabled": true,"builtin": false,"editable": false,"basePath": "/platform/ingest/custom/events","segment": "home","displayName": "Endpoint for home automation","defaultBucket": "home_automation_events","processors": [{"type": "fieldsRename","enabled": false,"editable": true,"id": "hostname-field-normalizer","description": "hostname field normalizer","matcher": "isNotNull(\"hostname\")","sampleData": "{\"hostname\": \"raspberry-pi 4\",\"ip\":\"10.0.0.123\"}","fields": [{"fromName": "hostname","toName": "host.name"},{"fromName": "ip","toName": "ip.address"}]},{"type": "fieldsAdd","enabled": false,"editable": true,"id": "add-source-field","description": "Add source field","matcher": "true","sampleData": "{\"hostname\": \"raspberry-pi 4\",\"ip\":\"10.0.0.123\"}","fields": [{"name": "source","value": "home-automation"}]}],"routing": {"type": "dynamic"}},{"enabled": true,"builtin": true,"editable": false,"basePath": "/platform/ingest/v1/events","segment": "","displayName": "Default API","defaultBucket": null,"processors": [],"routing": {"type": "dynamic"}}],"pipelines": [{"type": "default","enabled": true,"editable": false,"id": "home-automation","builtin": false,"displayName": "Home automation pipeline","storage": {"editable": false,"catchAllBucketName": "home_automation_events","processors": [{"type": "noStorage","id": "don-not-store-debug-events","description": "Do not store debugging events","enabled": true,"editable": false,"matcher": "severity==\"debug\"","sampleData": "{}"},{"type": "bucketAssignment","enabled": true,"editable": false,"id": "bucket-assignment-security-relevent-events","description": "Store security relevant events in dedicated bucket","matcher": "type==\"security\"","sampleData": "{}","bucketName": "home_automation_security_events"}]},"securityContext": {"editable": false,"processors": [{"type": "securityContext","id": "security-context","description": "Mark security context for supervisors","enabled": true,"editable": false,"matcher": "type==\"security\"","sampleData": "{}","value": {"type": "constant","constant": "supervisors"}}]},"metricExtraction": {"editable": false,"processors": [{"type": "counterMetric","id": "click-counter-metric","description": "Counts the clicks on a button","enabled": true,"editable": true,"matcher": "device.type==\"button\"","sampleData": "{}","metricKey": "events.home.button.click","dimensions": ["device.name","device.location"]},{"type": "valueMetric","id": "temperature-value-metric","description": "description","enabled": true,"editable": true,"matcher": "device.type==\"temperature-sensor\"","sampleData": "{}","metricKey": "events.home.temperature","dimensions": ["device.name","device.location"],"field": "temperature"}]},"dataExtraction": {"editable": false,"processors": []},"processing": {"editable": false,"processors": []}},{"type": "default","enabled": true,"editable": false,"id": "default","builtin": true,"displayName": "events","storage": {"editable": false,"catchAllBucketName": "default_events","processors": []},"securityContext": {"editable": false,"processors": []},"metricExtraction": {"editable": false,"processors": []},"dataExtraction": {"editable": false,"processors": []},"processing": {"editable": false,"processors": []}}],"routing": {"editable": false,"catchAllPipeline": {"editable": false,"pipelineId": "default"},"entries": [{"enabled": true,"editable": false,"builtin": false,"pipelineId": "home-automation","matcher": "source==\"home-automation\"","note": "Route all home automation events into dedicated pipeline"}]}}
ConstantValueAssignment
objectAssign a constant value.
The constant value to assign.
FieldValueAssignment
objectAssign a value extracted from a field.
The field on the record to extract the value for assignment.
ConstantMultiValueAssignment
objectAssign a multi-value constant.
The constant multi value to assign.
StaticRouting
objectRecords are statically routed to the defined pipeline.
Identifier of the pipeline.
DynamicRouting
objectRecords are routed via the dynamic routes.
Defines the actual set of fields depending on the value. See one of the following objects:
static
-> StaticRoutingdynamic
-> DynamicRoutingdynamic
static
ClassicPipelineDefinition
objectDefinition of a classic pipeline which are configured via settings 2.0. This only applies to the logs and bizevents configuration.
The settings-schema identifier related to the processing of the classic pipeline.
ClassicProcessingStage
objectProcessing stage configuration of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
ClassicProcessingStageProcessor
objectGroups all processors applicable for the ClassicProcessingStage. Applicable processor is SxqlProcessor.
DefaultPipelineDefinition
objectDefinition of a single default pipeline.
ProcessingStage
objectProcessing stage configuration of the pipeline.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
ProcessingStageProcessor
objectGroups all processors applicable for the ProcessingStage. Applicable processors are DqlProcessor, FieldsAddProcessor, FieldsRemoveProcessor, FieldsRenameProcessor, TechnologyProcessor and DropProcessor.
BizeventExtractionProcessor
objectProcessor to extract a bizevent. This processor can only be applied to the logs configuration. Fields event.type and event.provider can only be assigned to a constant or field value. A multi-value constant is not supported for those fields.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
ValueAssignment
objectStrategy to assign a value.
Defines the actual set of fields depending on the value. See one of the following objects:
constant
-> ConstantValueAssignmentfield
-> FieldValueAssignmentmultiValueConstant
-> ConstantMultiValueAssignmentconstant
field
multiValueConstant
FieldsExtraction
objectDefinition of the field extraction.
Unique fields to include/exclude in the extracted record.
Defines how the fields of the source record should be extracted. INCLUDE: Only the specified fields are extracted. INCLUDE_ALL: All fields are extracted. EXCLUDE: All fields except the specified fields are extracted.
EXCLUDE
INCLUDE
INCLUDE_ALL
DavisEventExtractionProcessor
objectProcessor to extract a davis event.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
DavisEventProperty
objectList of properties for the extracted davis event.
The key to set on the davis event.
The value assigned to the key.
DqlProcessor
objectProcessor to apply a DQL script.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
The DQL script to apply on the record.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
FieldsAddProcessor
objectProcessor to add fields.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
FieldsAddItem
objectList of fields to add to the record.
Name of the field.
Value to assign to the field.
FieldsRemoveProcessor
objectProcessor to remove fields.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
List of unique fields to remove from the record.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
FieldsRenameProcessor
objectProcessor to rename fields.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
FieldsRenameItem
objectList of fields to rename on the record.
The field to rename.
The new field name.
TechnologyProcessor
objectProcessor to apply a technology processors.
Indicates if the object is provided by Dynatrace or customer defined.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Sample data related to the processor for documentation or testing.
The reference identifier to a specific technology. This technology is applied on the record.
DropProcessor
objectProcessor to drop the record either during the processing stage or at the endpoint.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
NoStorageProcessor
objectProcessor to skip storage assignment.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
BucketAssignmentProcessor
objectProcessor to assign a bucket.
Bucket that is assigned when the record is matched.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
SecurityContextProcessor
objectProcessor to set the security context field.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
Sample data related to the processor for documentation or testing.
ValueAssignment
objectStrategy to assign a value.
Defines the actual set of fields depending on the value. See one of the following objects:
constant
-> ConstantValueAssignmentfield
-> FieldValueAssignmentmultiValueConstant
-> ConstantMultiValueAssignmentconstant
field
multiValueConstant
CounterMetricExtractionProcessor
objectProcessor to write the occurrences as a metric.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
List of unique dimensions to add to the metric.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
The key of the metric to write.
Sample data related to the processor for documentation or testing.
ValueMetricExtractionProcessor
objectProcessor to extract a value from a field as a metric.
Indicates if the object is provided by Dynatrace or customer defined.
Name or description of the processor.
List of unique dimensions to add to the metric.
Indicates if the user is allowed to edit this object based on permissions and builtin property.
Indicates if the object is active.
The field to extract the value for the metric.
Identifier of the processor. Must be unique within a stage.
Matching condition to apply on incoming records.
The key of the metric to write.
Sample data related to the processor for documentation or testing.
ErrorResponseEnvelope
objectEncloses the encountered error.
ErrorResponse
objectBasic information of the encountered error.
The returned HTTP status code.
Description of the encountered error.
ErrorResponseDetails
objectDetailed information of the error.
Defines the actual set of fields depending on the value. See one of the following objects:
constraintViolation
-> ConstraintViolationDetailsconstraintViolation
ConstraintViolationDetails
objectList of encountered constraint violations.
ConstraintViolation
objectInformation about a single constraint violation.
Description of the constraint violation.