Custom metrics for Log Monitoring

You can create a metric to make your current analysis available for charting and API usage. Select the logs that you're interested in. Then use the query language to search for relevant text patterns inside the selected logs that can be used for your custom metric.

For details on how custom metrics affect your monitoring consumption, see Custom metrics.

Dynatrace monitors and examines both log files that remain on the host system and log files that are stored on the Dynatrace server. A custom metric can be created only for monitored logs (log files that are stored on the Dynatrace server). If you use Log Monitoring as an ad hoc troubleshooting tool for a specific process or host, you'll likely view host-specific logs that haven't been designated for monitoring (that is, stored). As a result, the custom metric feature isn't available for such logs.

Create metric

You can create a custom metric that identifies pattern matches within the selected logs. When creating metrics, you need to be aware of what type of logs you expect the metric to appear in. Typical logs are based either on hosts or processes.

Custom devices

Creating a metric is possible only for logs that are based on hosts or processes. If your log selection includes a log that's based on a custom device, you have to unselect that log to create a metric.

When creating a custom metric, if your log selection includes both types of logs (host and process), you must select just one type of log for this metric. By default, the log type with the most log entries is selected.

Create metric panel for Log Monitoring with Host - Process conflict

Change selection

If you change the log selection, make sure you select Display results to refresh the Create metric panel before creating the metric.

Create metric panel for Log Monitoring

Enter the Metric name to have the Metric key for API usage generated automatically based on the metric name. You can modify this metric key. However, once created, the metric key can no longer be changed.

By default, the top results limit is set to 100 and is not configurable.

Metric options

You can use metrics to create custom charts and create events for alerting, and you can manage them via API.

Create a custom chart

You can use this metric to create a custom chart. When creating a custom chart, select the new custom metric or other metrics related to the processes or hosts you want to monitor. Then select a chart type and aggregation types for the metrics you've selected. You can also make your custom chart tile appear on your dashboard.

Create an alert

To use a custom metric to create an alert, define a custom event with the new custom metric.

API URL

Use the metric key for the API to receive either one aggregated data point per series or a list of data points per series.

To execute API requests, remember that you need to be authenticated.

Manage metrics

Example

To create a log metric and pin a chart of the metric to your dashboard

  1. On the Logs page, run a query against your logs.
  2. Select Create metric to create a custom metric based on the query.
  3. Enter the Metric name to have the Metric key for API usage generated automatically based on the metric name. You can modify this metric key. However, once created, the metric key can no longer be changed.
  4. Select Create metric.
    The Metric successfully created panel is displayed.
  5. Select Create a custom chart to chart your metric and, optionally, pin it to a dashboard.
  6. On the Custom chart page, find and select your metric.
    A chart is automatically generated.
  7. Select Pin to dashboard to add a chart of your metric to a dashboard.