Appearance

CentOS / Red Hat Enterprise Linux派生OSにインストールする ​

KCPS版Mackerelをご利用の場合はこちら

パッケージをインストールする

あらかじめ エージェントのインストール時に発生する通信 を許可してください。

セットアップスクリプトを実行してインストールする

新規ホストの登録 画面で CentOS / Red Hat を選択し、表示されたコマンドを実行します。

curl -fsSL https://mackerel.io/file/script/setup-all-yum-v2.sh | MACKEREL_APIKEY='<YOUR_API_KEY>' sh

インストール完了後にエージェントは自動で起動します。エージェントが起動するとMackerelにホストとして登録されます。ホスト一覧 画面を確認してください。

ホストが登録されない場合は、FAQ：ホストが登録されない の内容を確認してください。

rpmコマンドを使用してインストールする

GitHub の Release ページ で公開している最新版のパッケージを、rpmコマンドを使用してインストールします。

インストールが完了したら mackerel-agent.conf にAPIキーを設定し、エージェントの再起動を行います。APIキーは WebコンソールのAPIキータブ から取得できます。

apikey = "<YOUR_API_KEY>"

エージェントを再起動する

エージェントを再起動する場合は以下のコマンドを実行します。

sudo systemctl restart mackerel-agent

エージェントのログを確認する

エージェントのログはJournalに出力されます。以下のコマンドで確認できます。

sudo journalctl -u mackerel-agent.service

エージェントをバージョンアップする

エージェントをバージョンアップする場合は以下のコマンドを実行します。

sudo yum update mackerel-agent

エージェントをアンインストールする

エージェントをアンインストールする場合は以下のコマンドを実行します。

sudo yum remove mackerel-agent

KCPS版mackerel-agentをRPMパッケージでインストールする

yumコマンドを使用する

まずMackerelのyumリポジトリを登録します:

curl -fsSL http://198.18.0.16/file/setup-yum-kcps.sh | sh

その後、yumコマンドを用いてインストールできます:

sudo yum install mackerel-agent-kcps

エージェントのアップデートもyumコマンドから行えます:

sudo yum update mackerel-agent-kcps

rpmコマンドを使用する

rpmコマンドでインストールするには、以下のコマンドを実行します:

sudo rpm -ivh http://198.18.0.16/file/rpm/mackerel-agent-kcps-latest.noarch.rpm

アップデートの際は、以下のコマンドを実行してください:

sudo rpm -Uvh http://198.18.0.16/file/rpm/mackerel-agent-kcps-latest.noarch.rpm

設定ファイルを編集

/etc/mackerel-agent-kcps/mackerel-agent-kcps.conf ファイルを編集して、APIキーを設定してください。

apikey = "<YOUR_API_KEY>"

APIキーはオーガニゼーションのページから確認できます。このAPIキーでオーガニゼーションを識別しますので、APIキーは外部に漏らさないようご注意ください。

詳細はmackerel-agent仕様をご覧ください。

設定ファイルを利用して、以下のことを実現できます:

エージェントを起動する

以下のコマンドを実行することでエージェントが起動します。

sudo /etc/init.d/mackerel-agent-kcps start

/var/log/mackerel-agent-kcps.logにエージェントのログが出力されます。

エージェントが正しく動きはじめると、Mackerelにホストとして登録されます。ダッシュボードなどでご確認ください。

エージェントのアンインストール

mackerel-agentをアンインストールするには、以下のコマンドを実行してください。

yumでインストールした場合:

sudo yum remove mackerel-agent-kcps

rpmでインストールした場合:

sudo rpm -e mackerel-agent-kcps

またその際、デフォルトでは /var/lib/mackerel-agent-kcps/id にホストIDの記録されたファイルが残っているため、これを削除してください。