mackerel-agent

README

mackerel-agent

mackerel-agent is an agent program to post your hosts' metrics to Mackerel.

mackerel-agent executes the following tasks in foreground:

• Register your host to Mackerel
• Collect and post specs and metrics of your host to Mackerel periodically

You can see the information of the host on Mackerel.

For now, mackerel-agent is guaranteed to run only on CentOS 5/6 and Debian 6/7.

SYNOPSIS

Build and Run mackerel-agent.

make build
make run

The apikey is required to run the agent.

Create an organization in Mackerel and configure apikey in mackerel-agent.conf.

The following commands can be used instead of 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

Test

Test mackerel-agent.

The agent collects information about a host which the agent run.

make test

License

Copyright 2014 Hatena Co., Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.