Watchdog Insights for Logs

Watchdog Insights for Logs

Overview

With Watchdog Insights, find your way faster to the root cause of problems with contextual insights you receive as you explore logs. Watchdog Insights complements your expertise and instincts, giving nudges toward where you could focus your troubleshooting attention.

Watchdog Insights for the Log Explorer is a beta feature, rolling out to customers using Log Management. If you have feedback, contact Datadog support.

In the following example, Watchog Insights highlights that version:2.9.7 of a containerized Ruby application causes most of the errors observed in a specific time range.

The Watchdog Insights banner appears in the Log Explorer results page and surfaces insights relevant to the current query:

To see a quick overview of insights, expand the Watchdog Insight banner:

For richer troubleshooting inspiration, click View all to open the Watchdog Insights side panel:

Each insight comes with its own embedded interactions and side panel with detailed troubleshooting material. The insight interactions and side panel vary depending on the type of Watchdog Insight.

Collections

Error outliers

An error outliers insight shows fields (that is, faceted tags or attributes) that are characteristic of errors matching the current query. This casts light on key:value pairs that are statistically over-represented among the errors, giving you hints on the possible root cause of problems.

Typical error outliers examples are env:staging, docker_image:acme:3.1 http.useragent_details.browser.family:curl.

  • The banner card version of the insight shows:

    • The name of the field.
    • The proportion of errors and overall logs that this field is contributing.
  • The side panel card of the insight shows, in addition:

    • The main log pattern for error logs that have the field.
  • The full side panel of the card shows, in addition:

    • The timeseries for error logs that have the field.
    • Other fields that are often associated with those logs.
    • A comprehensive list of log patterns for those logs.

Further Reading