mackerel-agent

mackerel-agent is a client software for Mackerel. Mackerel is an online visualization and monitoring service for servers.

Once mackerel-agent is installed, it runs the following tasks on the installed host in foreground:

Once mackerel-agent is installed, it runs the following tasks on the installed host in foreground:

  • register your hosts to Mackerel
  • collect specs and metrics of those hosts and post them to Mackerel

Collected information will be visualized on Mackerel.

PREREQUISITES

You have to create an organization on Mackerel at first.
After that, specify apikey value in mackerel-agent.conf with the following command.

% mackerel-agent init -apikey {{YOUR_APIKEY}}

SYNOPSIS

Build and Run the mackerel-agent.

% make build
% make run

You can run the following commands instead of using make.

% go get -d github.com/mackerelio/mackerel-agent
% go build -o build/mackerel-agent \
  -ldflags="\
    -X github.com/mackerelio/mackerel-agent/version.GITCOMMIT `git rev-parse --short HEAD` \
    -X github.com/mackerelio/mackerel-agent/version.VERSION   `git describe --tags --abbrev=0 | sed 's/^v//' | sed 's/\+.*$$//'` " \
  github.com/mackerelio/mackerel-agent
./build/mackerel-agent -conf=mackerel-agent.conf

On Windows

Use .bat files instead of make commands.

% build.bat

Test

Test mackerel-agent to confirm it's working properly.

The agent will collect information about the host on which it has been installed.

% make test

GitHub

https://github.com/mackerelio/mackerel-agent