Learn how to manage external links.

External links provide integration between Wavefront and external systems. If you use logging systems such as ELK and Splunk, you can easily construct a meaningful URL to navigate from Wavefront to a log entry.

Suppose while analyzing metrics data you find an anomaly such as an unexpected drop in transaction rate and you want to navigate to logs to look for entries that could shed light on why the transaction rate drop occurred. External links allow you to click through from a Wavefront series directly to a related entry in your logging system.

External links are general purpose: you can link through to any type of system, not just logs.

To view and manage external links, select Browse > External Links.

  1. Right-click a series. The series context menu displays.
  2. Select External Links > <linkname>, where <linkname> is the name specified when the link was created. Only series that match all the filters specified when the link was created display <linkname> in the External Links context menu. For example:

    External links

  1. Select Browse > External Links.
  2. Click Create External Link.
  3. Specify a link name and description.
  4. Optionally specify metric name, source name, and point tag value filters as Javascript regular expressions that the series must match.
    TypeDescriptionExample
    Metric Filter Regex A regular expression that metric names must match. jvm.memory.heap\w+
    Source Filter Regex A regular expression that source names must match. co-2a-app[0-9]+-i-\d+
    Point Tag Filter Regexes A point tag key and a regular expression that point tag values must match. Tag Key=env
    Filter Regex=prod\w+

    Specify the external link URL template. The template employs Mustache syntax. The properties supported by the template are:

    PropertyDescription
    source The source of the series.
    startEpochMillis Starting time of the chart window, in milliseconds from the UNIX epoch.
    endEpochMillis Ending time of the chart window, in milliseconds from the UNIX epoch.
    <pointTagName1>, <pointTagName2>,... One or more point tag names associated with the series.

    You can apply functions to transform their enclosed sections. All functions begin with the namespace functions.

    FunctionDescription
    urlEncode URL Encoder
    epochMillisToEpochSeconds Converts epoch milliseconds to epoch seconds.
    epochMillisToISO Converts epoch milliseconds to an ISO8601 representation.
    epochMillisEra,epochMilliscenturyOfEra, epochMillisyearOfEra,epochMillisYearOfCentury, epochMillisYear,epochMillisMonthOfYear, epochMillisDayOfYear,epochMillisDayOfMonth, epochMillisWeekyear,epochMillisWeekOfWeekyear, epochMillisDayOfWeek,epochMillisHalfDayOfDay, epochMillisClockHourOfHalfday,epochMillisClockHourOfDay, epochMillisHourOfHalfday,epochMillisHourOfDay, epochMillisMinuteOfDay,epochMillisMinuteOfHour, epochMillisSecondOfDay,epochMillisSecondOfMinute, epochMillisMillisOfDay,epochMillisMillisOfSecond 0 for BC, 1 for AD. See Joda-Time - Java date and time API.
  5. Click Save.

Example URL Template

Consider the following external link URL template, which references the point tag name service:

http://<hostname>?time:(from:'{{#functions.epochMillisToISO}}{{startEpochMillis}}{{/functions.epochMillisToISO}}',to:'{{#functions.epochMillisToISO}}{{endEpochMillis}}{{/functions.epochMillisToISO}}'))&{{#functions.urlEncode}}host:{{source}} AND source:"/mnt/logs/{{service}}.log"{{/functions.urlEncode}}'))

This template contains the substring:

{{#functions.urlEncode}}host:{{source}} AND source:"/mnt/logs/{{service}}.log"{{/functions.urlEncode}}

Assuming source=test and service=alerting, the template evaluates to:

{{#functions.urlEncode}}host:test AND source:"/mnt/logs/alerting.log"{{/functions.urlEncode}}

The string inside the function delimiters is URL encoded as:

host%3Atest%20AND%20source%3A%22%2Fmnt%2Flogs%2Falerting.log%22

Video Overview

Here’s a video overview of external links: