Custom metrics for Log Monitoring v1
You are viewing documentation for Log Monitoring v1. Dynatrace Log Monitoring v1, is considered a legacy solution.
Log Monitoring v1 will reach the end of life and will be switched off in November 2023.
We strongly encourage you to switch to the latest Dynatrace Log Monitoring version.
Dynatrace SaaS
If you are currently using Dyantrace SaaS, upgrade to the latest version of Dynatrace log monitoring.
Dynatrace Managed
If you are currently using Dyantrace Managed deployemnts, upgrade to the Log Monitoring Classic version of Dynatrace 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 DDUs for 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.
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.
If you change the log selection, make sure you select Display results to refresh the Create metric panel before creating the metric.
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
Use metrics to create charts and events for alerting. You can manage them via the Metrics API.
Create a chart
Use Data explorer to query and chart metrics.
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
- On the Logs page, run a query against your logs.
- Select Create metric to create a custom metric based on the query.
- 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.
- Select Create metric.
The Metric successfully created panel is displayed. - Select Create a custom chart to chart your metric and, optionally, pin it to a dashboard.
- On the Custom chart page, find and select your metric.
A chart is automatically generated. - Select Pin to dashboard to add a chart of your metric to a classic dashboard. For details, see Pin tiles to your dashboard.