Ensure order of configurations

This guide shows how to enforce the order of configurations using Dynatrace Configuration as Code via Monaco (Dynatrace Monaco CLI).

Goal

While the web UI allows you to define the order of certain configurations, it's not possible to define an order with the Dynatrace Monaco CLI or the Dynatrace API.

However, you can use the way the Dynatrace Monaco CLI handles dependencies between configurations to enforce rule order.

Define rule order using dependencies

By creating fake dependencies between rules, the Dynatrace Monaco CLI ensures that a rule is created before another rule that depends on it. This workaround is successful only if all the rules are created from the Dynatrace Monaco CLI and don't already exist.

Because newly added rules are prepended to existing rules, you will likely need to define dependencies in the opposite order than you expect. The following sample shows how to ensure order using dependencies.

Consider the following example showing a config.yaml file containing two app detection rules named rule1 and rule2.

configs:
  - id: rule2
    config:
      name: rule2
      template: rule2.json
      skip: false
    type:
      settings:
        schema: builtin:rum.web.app-detection
        schemaVersion: 2.0.1
        scope: environment
  - id: rule1
    config:
      name: rule1
      template: rule1.json
      skip: false
    type:
      settings:
        schema: builtin:rum.web.app-detection
        schemaVersion: 2.0.1
        scope: environment

During the deployment process, rule2 probably will be deployed before rule1. However, to guarantee that rule1 is always deployed before rule2, you can introduce a pseudo reference parameter within rule2, indicating its dependency on rule1. This ensures that rule2 is deployed after rule1.

configs:
  - id: rule2
    config:
      name: rule2
      template: rule2.json
      skip: false
      parameters:
        order:
          configId: rule1
          property: id
          type: reference
    type:
      settings:
        schema: builtin:rum.web.app-detection
        schemaVersion: 2.0.1
        scope: environment
  - id: rule1
    config:
      name: rule1
      template: rule1.json
      skip: false
    type:
      settings:
        schema: builtin:rum.web.app-detection
        schemaVersion: 2.0.1
        scope: environment