graphite

README

go-graphite-client

go-graphite-client - Simple Golang graphite client.

Example usage (also present in example_text.go)

package main

import (
	"log"

	graphite "github.com/jtaczanowski/go-graphite-client"
)

func main() {
	graphiteClient := graphite.NewClient("localhost", 2003, "metrics.prefix", "tcp")

	// metrics
	exampleMetric1 := map[string]float64{"test_metric": 1234.1234}
	exampleMetric2 := map[string]float64{"test_metric2": 12345.12345}
	// list of the metrics
	metricsToSend := []map[string]float64{exampleMetric1, exampleMetric2}

	// graphiteClient.SendData(data []map[string]float64) error - this method receives a list of metrics as an argument
	if err := graphiteClient.SendData(metricsToSend); err != nil {
		log.Printf("Error sending metrics: %v", err)
	}
}

Documentation

Overview

Simple Graphite client

Example

package main

import (
	"log"

	"github.com/jtaczanowski/go-graphite-client"
)

func main() {
	graphiteClient := graphite.NewClient("localhost", 2003, "metrics.prefix", "tcp")

	// metrics
	exampleMetric1 := map[string]float64{"test_metric": 1234.1234}
	exampleMetric2 := map[string]float64{"test_metric2": 12345.12345}
	// list of the metrics
	metricsToSend := []map[string]float64{exampleMetric1, exampleMetric2}

	// graphiteClient.SendData(data []map[string]float64) error - this method receives a list of metrics as an argument
	if err := graphiteClient.SendData(metricsToSend); err != nil {
		log.Printf("Error sending metrics: %v", err)
	}
}

Index

• type Client
  • func NewClient(Host string, Port int, Prefix string, Protocol string) *Client
  • func (g *Client) SendData(data []map[string]float64) error

Examples

• Package

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client - struct with Graphite connection settings

func NewClient

func NewClient(Host string, Port int, Prefix string, Protocol string) *Client

NewClient - returns new Client

func (*Client) SendData

func (g *Client) SendData(data []map[string]float64) error

SentData - pushes data to Graphite server. Default connect timeout is set to 3s

SentData receives as argument []map[string]int64 where string is metric name, float64 is metric value, example:

map[string]float64{"test": 1234.1234}