signalfx-detector-syncer 0.6

SignalFx detector sync utility

sfx-sync-detectors is a command-line tool that helps keep SignalFx detectors in version control and sync them with SignalFx. It operates over a directory of files, each representing a detector, and makes sure that what is in SignalFx matches the contents of that directory.

Installation

$ pip install signalfx-detector-syncer

Usage

$ sfx-sync-detectors --token=$SFX_AUTH_TOKEN /path/to/detectors/

For full usage information, run with -h or --help.

How it works

The syncer works by file name. Each detector is written in its own file, either in JSON or YAML format and named as an easily identifiable dash-separated-slug (.json or .yaml). This slug name identifies the detector: updates to the same file will update the existing detector. Creating a new file creates a new detector; removing a file removes the corresponding detector from SignalFx.

Detectors managed by the syncer are identified within SignalFx by multiple tags:

• a signalfx-detector-syncer tag, present on all detectors created and managed by the detector syncer;

• a from:<filename> tag, specific to a particular detector, which ties the detector to the file it came from in the synced directory;

• optionally, a <team> identifier tag that further scopes the detector (see below Team scoping).

JSON

When the file contains JSON, it is expected to contain the direct JSON detector model that would be pushed to SignalFx’s detector API.

YAML layout

For YAML (more human readable!), each file contains two YAML documents separated by the expected --- line. The first document, the front matter, defines the configuration of the detector and its rules and notifications. The second document is the SignalFlow 2.0 program text of the detector.

---
name: The detector name
description: The detector description
tags: [latency, demo]
rules:
  my label:
    severity: Critical
    description: Something's wrong!
    notifications:
      - type: Email
        email: [e-mail]
---

detect(when(data('demo.trans.latency') > 220, lasting='5s')).publish('my label')

Specification

The specification of the front matter that configures the detector is pretty much what the detector API expects. The only expection is that rules may directly keyed by the detect label they map to if you want to.

Team scoping

If you want, you can limit the scope of detectors that the syncer will consider by specifying the --team option with an identifier. This will be used as an additional piece of information that the syncer looks for when considering which detectors should be updated or removed.