List processors for a technology bundle in Dynatrace OpenPipeline, using the technology bundle ID to retrieve its processors.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/openpipeline/v1/technologies/{id}/processors |
You provide the technology bundle ID in the path as id. Dynatrace returns the list of all processors within that specific technology bundle.
To execute this request, you need a platform token or OAuth access token with openpipeline:configurations:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| id | string | The ID of a technology bundle. | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | Processing | List of all processors within a specific technology bundle. |
| 4XX | Error | Client-side error. |
| 5XX | Error | Server-side error. |
ResponseBody objectProcessingStageProcessor objectGroups all processors applicable for the ProcessingStage. Applicable processors are DqlProcessor, FieldsAddProcessor, FieldsRemoveProcessor, FieldsRenameProcessor, TechnologyProcessor, and DropProcessor.
DqlProcessor objectProcessor to apply a DQL script.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| description | string | Name or description of the processor. |
| dqlScript | string | The DQL script to apply on the record. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| id | string | Processor identifier, which must be unique within a stage. |
| matcher | string | Matching condition to apply to incoming records. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
FieldsAddProcessor objectProcessor to add fields.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| description | string | Name or description of the processor. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| fields | Fields | List of fields to add to the record. |
| id | string | Processor identifier, which must be unique within a stage. |
| matcher | string | Matching condition to apply to incoming records. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
FieldsRemoveProcessor objectProcessor to remove fields.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| description | string | Name or description of the processor. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| fields | string[] | List of unique fields to remove from the record. |
| id | string | Processor identifier, which must be unique within a stage. |
| matcher | string | Matching condition to apply to incoming records. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
FieldsRenameProcessor objectProcessor to rename fields.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| description | string | Name or description of the processor. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| fields | Fields | List of fields to rename on the record. |
| id | string | Processor identifier, which must be unique within a stage. |
| matcher | string | Matching condition to apply to incoming records. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
TechnologyProcessor objectProcessor to apply a technology processors.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| customMatcher | string | Optional customer-defined matching condition, that's used in place of the main technology matcher. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| id | string | Processor identifier, which must be unique within a stage. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
| technologyId | string | 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.
| Element | Type | Description |
|---|---|---|
| builtin | boolean | Indicates if Dynatrace provides the object or if it's customer-defined. |
| description | string | Name or description of the processor. |
| editable | boolean | Indicates if the user can edit this object based on permissions and builtin property. |
| enabled | boolean | Indicates if the object is active. |
| id | string | Processor identifier, which must be unique within a stage. |
| matcher | string | Matching condition to apply to incoming records. |
| sampleData | string | Sample data related to the processor for documentation or testing. |
FieldsAddItem objectList of fields to add to the record.
| Element | Type | Description |
|---|---|---|
| name | string | Name of the field. |
| value | string | Value to assign to the field. |
FieldsRenameItem objectList of fields to rename on the record.
| Element | Type | Description |
|---|---|---|
| fromName | string | The field to rename. |
| toName | string | The new field name. |
ErrorResponseEnvelope objectEncloses the encountered error.
| Element | Type | Description |
|---|---|---|
| error | Error | Basic information of the encountered error. |
ErrorResponse objectBasic information of the encountered error.
| Element | Type | Description |
|---|---|---|
| code | integer | The returned HTTP status code. |
| details | Error | Detailed information of the error. |
| message | string | Description of the encountered error. |
ErrorResponseDetails objectDetailed information of the error.
| Element | Type | Description |
|---|---|---|
| type | string | Defines the actual set of fields depending on the value. See one of the following objects:
The element can hold these values
|
[{"type": "dql","enabled": true,"editable": false,"id": "es_slow_log","description": "ES Slow Log Index","matcher": "matchesPhrase(content, \"index.indexing.slowlog*\")","sampleData": "{}","dqlScript": "parse content, \"'[' TIMESTAMP('yyyy-MM-ddTHH:mm:ss,SSS'):timestamp ']' PUNCT?\nSPACE? '[' UPPER:loglevel SPACE* ']' PUNCT?\nSPACE? '[index.indexing.slowlog.' LD:'db.operation' ']' PUNCT?\nSPACE? '[' LD:'db.elasticsearch.node' ']' PUNCT?\n(SPACE? '{' LD '}')? //metadata, dt.trace_id\nSPACE? '[' LD?:'db.elasticsearch.index_name' ']' PUNCT?\nSPACE? 'took[' LD ']' PUNCT?\nSPACE? 'took_millis[' INT:'db.elasticsearch.duration' ']' PUNCT?\nDATA\"\n"}]
{"error": {"code": 400,"message": "Bad request."}}