インストールしたエージェントが起動に失敗する / インストール時にエラーが発生する / インストールがおこなえない、などの際には、以下の点について、改めて確認してください。

インストール対象の環境について

• インストール対象のOSが公式サポートされているものかどうかを確認してください。
  • 対象環境 - Mackerel ヘルプ

通信状況について

• インストール対象のサーバーから、MackerelがホストされているIPアドレスとポート番号を教えて下さい に列挙されている宛先への通信がおこなえることを確認してください。
  • プロキシサーバー経由での通信が必要な場合には、mackerel-agentが使用する経路は制御できますか？ を参考にプロキシサーバーの設定を実施してください。
• エージェントをインストールしているサーバーにウイルス対策ソフトウェアがインストールされている場合、mackerel-agentの通信が阻害されていないことを確認してください。
• api.mackerelio.comが名前解決できているかどうかを確認してください。 

その他全般

• パッケージ（yum / apt）が正しくインストールされているかを確認してください。
• mackerel-agent に指定しているAPIキーが ReadOnly なものでないことを確認してください。
• mackerel-agent が出力しているログの内容を確認し、エラーが出力されていないかどうかを確認してください。
• 設定ファイル mackerel-agent.conf が正しく記述できているかどうか、コマンド mackerel-agent configtest によりチェックしてください。
• Docker ImageやAMIなどによりOSイメージ化した際に/var/lib/mackerel-agent/idもコピーしている場合、このファイルを削除する必要があります。
  • mackerel-agentは初回起動時にサーバーが発行したIDを/var/lib/mackerel-agent/idに保存します。以後はこのファイルに記載されたIDによりホストの識別を行います。
  • そのため、/var/lib/mackerel-agent/idがコピーされると実際は複数のホストがMackerel上では同一のホストと認識され、メトリックの投稿や監視が正しく動作しなくなります。

全てを確認した上で問題が解消されない場合は、「サポートチームへ連絡」からお問い合わせください（エラーログなどがある場合には添付をお願いいたします）。「サポートチームへ連絡」は、当ページヘッダ部分、もしくはMackerel Webコンソールのヘッダ部分に表示されています。