Command Line Tool for Mackerel
Go Perl Shell Makefile
Latest commit 6bde406 Jan 11, 2017 @syou6162 syou6162 committed on GitHub Merge pull request #81 from mackerelio/bump-version-0.14.1
Release version 0.14.1

README.md

mkr

Latest Version Build Status Go Documentation

mkr - Command Line Tool For Mackerel written in Go.

DESCRIPTION

mkr is a command-line interface tool for the Mackerel API written in Go. mkr helps to automate tedious daily server operations to best leverage Mackerel's and Unix's tools. mkr output format is JSON, so it can be filtered with a JSON processor such as jq.

INSTALLATION

Install the plugin package from either the yum or the apt repository.

CentOS 5/6

curl -fsSL https://mackerel.io/assets/files/scripts/setup-yum.sh | sh
yum install mkr

Debian 6/7

curl -fsSL https://mackerel.io/assets/files/scripts/setup-apt.sh | sh
apt-get install mkr

Homebrew

You can also install from the brew rule we maintain, but we don't officially support the environment.

brew tap mackerelio/mackerel-agent
brew install mkr

Build from source

$ go get github.com/mackerelio/mkr
$ go install github.com/mackerelio/mkr

Linux (Docker)

https://registry.hub.docker.com/u/mackerel/mkr/

$ docker run mackerel/mkr --rm --entrypoint="cat" /go/bin/app > /usr/local/bin/mkr && chmod +x /usr/local/bin/mkr

USAGE

First the MACKEREL_APIKEY environment variable must be set. It is not necessary to set the MACKEREL_APIKEY on hosts running mackerel-agent. For more details, see below.

export MACKEREL_APIKEY=<Put your API key>

EXAMPLES

mkr status <hostId>
{
    "id": "2eQGEaLxiYU",
    "name": "myproxy001",
    "status": "standby",
    "roleFullnames": [
        "My-Service:proxy"
    ],
    "isRetired": false,
    "createdAt": "Nov 15, 2014 at 9:41pm (JST)"
}
mkr hosts --service My-Service --role proxy
[
    {
        "id": "2eQGEaLxiYU",
        "name": "myproxy001",
        "status": "standby",
        "roleFullnames": [
            "My-Service:proxy"
        ],
        "isRetired": false,
        "createdAt": "Nov 15, 2014 at 9:41pm (JST)"
    },
    {
        "id": "2eQGDXqtoXs",
        "name": "myproxy002",
        "status": "standby",
        "roleFullnames": [
            "My-Service:proxy"
        ],
        "isRetired": false,
        "createdAt": "Nov 15, 2014 at 9:41pm (JST)"
    },
]

The mkr hosts command has an '-f' option to format the output.

mkr hosts -f '{{range .}}{{if (len .Interfaces)}}{{(index .Interfaces 0).IPAddress}}{{end}}{{"\t"}}{{.Name}}{{"\n"}}{{end}}'
10.0.1.1  myproxy001
10.0.1.2  myproxy002
...
mkr create --status working -R My-Service:db-master mydb001
mkr update --status maintenance --roleFullname My-Service:db-master <hostId>
cat <<EOF | mkr throw --host <hostId>
<name>  <value> <time>
<name>  <value> <time>
EOF
...

cat <<EOF | mkr throw --service My-Service
<name>  <value> <time>
<name>  <value> <time>
EOF
...
mkr fetch --name loadavg5 2eQGDXqtoXs
{
    "2eQGDXqtoXs": {
        "loadavg5": {
            "time": 1416061500,
            "value": 0.025
        }
    }
}
mkr retire <hostId> ...

Examples (on hosts running mackerel-agent)

Specifing the and MACKEREL_APIKEY is not necessary because mkr refers to /var/lib/mackerel-agent/id and /etc/mackerel-agent/mackerel-agent.conf instead of specifying manually.

mkr status
mkr update --status maintenance <hostIds>...
mkr fetch -n loadavg5
cat <<EOF | mkr throw --host <hostId>
<name>  <value> <time>
EOF
mkr retire

ADVANCED USAGE

$ mkr update --st working $(mkr hosts -s My-Service -r proxy | jq -r '.[].id')

CONTRIBUTION

  1. Fork (https://github.com/mackerelio/mkr/fork)
  2. Create a feature branch
  3. Commit your changes
  4. Rebase your local changes against the master branch
  5. Run test suite with the go test ./... command and confirm that it passes
  6. Run gofmt -s
  7. Create new Pull Request

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.