Customize data with extensions

You can tailor various aspects of Dynatrace to the specifics of data acquired by your extension. You can also use the extension to introduce a new configuration in your environment (for example, organize data in dashboards, create new alerts, or introduce complex metrics).

Custom Dynatrace UI

The Extensions 2.0 framework enables you to tailor the Dynatrace UI for the specific needs of the data ingested by your extension. You can add customized dashboards or specialized unified analysis pages to your extension.

For more information, see Extend Dynatrace with domain-specific web UI.

Custom metric events

You can create custom metric events based on the metrics extracted by your extension and add the exported definitions to your extension archive. This way, you can distribute the custom metric events among Dynatrace environments.

Custom topology

After you start to send in your own data via an extension, you might be interested in extending the built-in topology model by adding your own domain-related entity types and relationships.

For more information, see Custom topology model.

Custom metric metadata

To add more context to data points and their dimensions ingested by your extension, your custom metric can carry additional useful information, such as the unit of measurement, display name, and value ranges.

You can provide such information via custom metric metadata. Metadata and data points are stored independently from data points and tied together by the metric key. You can push data points and set metadata in any order.

For more information, see Custom metric metadata.

Data filtering

Extensions also allow you to filter data based on specific criteria. This filtering capability is particularly useful for SNMP extensions, where you might want to limit the data that is ingested by the extension

Filters match entity names to include/exclude certain configurations from monitoring. This makes the data more relevant and saves unnecessary license consumption. Filters work with a specific entity type and support the following syntax:

Custom process group detection rules

Dynatrace detects which processes are part of the same process groups by means of a default set of detection rules. However, you can add your own process detection rules suited to the data retrieved by your extension.

For more information, see Process group detection.

Custom security context attribute

You can add a security context attribute to Dynatrace-provided and custom extensions. You can do this as part of the extension's activation, individually per each configuration, or you can edit the settings later.

You need to have a monitoring configuration for the selected extension. For more details on setting up a monitoring configuration via API, see Extensions 2.0 API - POST a monitoring configuration.

You can add security context from the Monitoring configurations tab of the chosen extension by selecting Edit from the Actions column. Then, select Next to go to the Attributes page.

The attribute is applied to all metrics, logs, and events produced by the configuration.

An API can also be used to set up a security context. For details, see Monitored entities API - security context.

Custom cost center and cost product attributes

You can add a cost center and a cost product attribute to Dynatrace-provided and custom extensions. You can do this as part of the extension's activation, individually per each configuration, or you can edit the settings later.

The fields are based on the following attributes:

To learn more about the field syntax, see Global field reference.

To add cost center and cost product attributes to your extension, you need to have a monitoring configuration for the selected extension. For more details on setting up a monitoring configuration via API, see Extensions 2.0 API - POST a monitoring configuration.

You can add security context from the Monitoring configurations tab of the chosen extension by selecting Edit from the Actions column. Then, select Next to go to the Attributes page.

The attributes are applied to all metrics, logs, and events produced by the configuration.

Log metrics, events, and processing rules

After you enable log ingestion into Dynatrace you can define the log metrics, events, and add your own log processing rules to be shipped with your extension.

For general information, on your logs configuration, see

The Extensions YAML file supports the same fields as the Settings 2.0 schemas:

You define your custom log configuration in the Extensions YAML file, starting with the following nodes in the root of the file

To learn the structure of the definition, check the Extensions schemas:

See Extension YAML file to learn how to get the schema JSON files.

Check the examples below on how to define your log metrics, events, and processing rules in the extension YAML file.

name: custom:dynatrace.logmetric.test.extension
version: 1.0.0
minDynatraceVersion: "1.281.0"
author:
  name: "John Doe"

logMetrics:
  - key: log.test.extension.occurrence
    query: content="AllProcessed"
    enabled: true
    measure: OCCURRENCE
  - key: log.test.extension.attribute
    query: content="AllProcessed"
    enabled: true
    measure: ATTRIBUTE
    measureAttribute: dt.os.type
  - key: log.test.extension.dimensions
    query: content="AllProcessed"
    enabled: true
    measure: OCCURRENCE
    dimensions: [
      dimension1,
      dimension2
    ]

ame: custom:dynatrace.logevent.test.extension2
version: 1.0.0
minDynatraceVersion: "1.281.0"
author:
  name: "John Doe"

logEvents:
  - query: content="a"
    enabled: true
    summary: abc
    eventTemplate:
      title: log_event_a
      description: ''
      eventType: CUSTOM_ALERT
      davisMerge: false
  - query: content="a"
    enabled: true
    summary: abd
    eventTemplate:
      title: abd
      description: My custom log event description :)
      eventType: CUSTOM_ALERT
      davisMerge: false

logProcessingRules:
  - ruleName: TopN statements masking
    query: event.group="query_performance"
    enabled: true
    ProcessorDefinition:
      rule: |
        USING(INOUT content) | FIELDS_ADD(content: REPLACE_PATTERN(content, "(\"'\"):p1 (LD):p2 (\"'\"):p3", "${p1}${p2|sha1}${p3}"))
    RuleTesting:
      sampleLog: |
        {
          "event.group": "query_performance",
          "content": "/*dt:ownQuery*/SELECT DECODE(name, 'sessions', value) AS sessions_limit, DECODE(name, 'processes', value) AS processes_limit FROM v$parameter WHERE name IN('sessions', 'processes')"
        }