README.md

SRE framework

Framework for golang applications which helps to send metrics, logs, traces and events into different monitoring tools or vendors.

Features

• Provide plain text, json logs with trace ID (if log entry is based on a span) and source line info
• Provide additional labels and tags for metrics, like: source line, service name and it's version
• Support logging tools (aka logs):
  • Stdout (text, json, template) based on Logrus
  • DataDog based on Logrus over UDP
  • NewRelic based on Logrus over TCP, as well as via LogAPI by using Telemetry
• Support monitoring tools (aka metrics)
  • Prometheus
  • DataDog
  • NewRelic
  • Opentelemetry
• Support tracing tools (aka traces)
  • Jaeger
  • DataDog
  • Opentelemetry
• Support eventing tools (aka events)
  • NewRelic
  • Grafana

Usage

Requirements

• Jaeger works with its Jaeger agent
• DataDog uses DataDog agent for logs, metrics and traces
• NewRelic uses NewRelic standalone infrastructure agent for logs
• NewRelic uses NewRelic Telemetry SDK for logs, metrics, traces, events
• Opentelemetry communicates with its Opentelemetry agent
• Grafana uses Grafana Annotations API

Set envs

Set proper GOROOT and PATH variables

export GOROOT="$HOME/go/root/1.17.4"
export PATH="$PATH:$GOROOT/bin"

Get Go modules

Set go.mod manually

module sre

go 1.17

require github.com/devopsext/sre vX.Y.Z

Collect go modules

go get

go: finding module for package github.com/devopsext/sre/provider
go: finding module for package github.com/devopsext/sre/common
go: found github.com/devopsext/sre/common in github.com/devopsext/sre vX.Y.Z
go: found github.com/devopsext/sre/provider in github.com/devopsext/sre vX.Y.Z

*vX.Y.Z - tag (version) of the framework, for instance => v0.0.7

Run one of example

• Logs
• Metrics
• Traces
• Events

Framework in other projects

• devopsext/events Kubernetes & Alertmanager events to Telegram, Slack, Workchat and other messengers.