Cinnamon 2.6 migration guide

This is a guide for migrating from Cinnamon 2.5 to Cinnamon 2.6.

Deprecated Trace Spans removed

The Trace Spans API, that was deprecated in Cinnamon 2.5, has been removed.

New unique address dimension

There is now a unique actor system address dimension for actor metrics, between the system and dispatcher dimensions. This dimension is disabled by default for backwards compatibility reasons. It represents the actor system address in the form host:port, with local being used if the actor system doesn’t have remoting enabled.

Note: If you have written your own Namer that does not respect the visibility setting of a Identity then your metric keys will now include the address dimension even if it hasn’t been enabled in configuration.

OpsClarity and Datadog reporters

The OpsClarity and Datadog plugins have been updated to be aligned with other metric reporters. Previously, these plugins provided an application.conf with default configuration for a StatsD reporter, including automatically enabling the reporter. These reporters now need to be enabled explicitly, and are configured in a reporter section that extends the StatsD reporter configuration and is only defined in a reference.conf.

To update your OpsClarity configuration, explicitly enable the opsclarity-reporter and move any configuration from cinnamon.opsclarity to the cinnamon.chmetrics.opsclarity-reporter section.

Similarly for Datadog, explicitly enable the datadog-reporter and move any configuration from cinnamon.datadog to the cinnamon.chmetrics.datadog-reporter section.

For example, given this configuration (for previous versions):

cinnamon.datadog {
  statsd {
    port = 8181
  }
  report {
    histogram = ["min", "max", "p95", "p99", "p999"]
  }
}

Use this configuration (for Cinnamon 2.6):

cinnamon.chmetrics {
  reporters += datadog-reporter

  datadog-reporter {
    port = 8181
    report {
      histogram = ["min", "max", "p95", "p99", "p999"]
    }
  }
}