はじめに
Instanaを触る機会があり、「そもそもエージェントが動いているのか？」という基本的なところから確認しました。
SSH接続のトラブルから設定ファイルの探索まで、実際にハマったポイントも含めてまとめます。
対象読者：Instanaを触り始めた人、エージェントの確認方法を知りたい人
環境・前提
| 項目 | 内容 |
|---|---|
| ローカルOS | macOS (Apple Silicon) |
| VM OS | RHEL系 Linux (vm-1) |
| Instana Agent | RHEL VM にインストール済み（/opt/instana/agent/） |
| 監視対象アプリ | Open Liberty (WebSphere Liberty Profile 10) |
| 接続方法 | SSH（秘密鍵認証、ポート 30666） |
前提：今回の構成
このハンズオンでは、以下の構成がすでに用意された状態からスタートします。
[macOS (ローカル)]
│ SSH接続
▼
[RHEL VM (vm-1)]
├── Instana Agent ← 今回確認するもの
└── Open Liberty ← 監視されるアプリサーバー
- Instana Agent は IBM Technology Zone (ITZ) 提供のVMにインストール済み
- エージェントの設定・動作確認を一から手を動かして確認する
全体の手順
| ステップ | 内容 |
|---|---|
| ① | SSH接続（仮想マシンに接続） |
| ② | Instana エージェントの稼働確認 |
| ③ | インストールディレクトリの構造確認 |
| ④ | 設定ファイルの場所と内容確認 |
① SSHでVMに接続する（ハマりポイントあり）
まずVMにSSHで接続しようとしたら、いきなりエラーが出ました。
ssh -i ~/Desktop/vm_ssh_key.vm -p 30666 itzuser@128.168.77.139
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/Users/hinano/Desktop/vm_ssh_key.vm' are too open.
Load key "/Users/hinano/Desktop/vm_ssh_key.vm": bad permissions
itzuser@128.168.77.139: Permission denied (publickey).
原因と解決
秘密鍵ファイルのパーミッションが 0644（他ユーザーも読める状態）だったため、SSHがセキュリティ上拒否していました。
# 秘密鍵のパーミッションを 600（自分だけ読み書き可）に変更
chmod 600 ~/Desktop/vm_ssh_key.vm
# 再接続 → 成功
ssh -i ~/Desktop/vm_ssh_key.vm -p 30666 itzuser@128.168.77.139
ポイント: SSH秘密鍵は必ず
chmod 600しておく。これを忘れがちなので注意。
② Instana エージェントが動いているか確認する
Instana エージェントはsystemdサービス として動作しています。
systemctlコマンドで、instana-agentが起動しているか確認します。
systemctl status instana-agent
● instana-agent.service - "Instana(tm) agent."
Loaded: loaded (/usr/lib/systemd/system/instana-agent.service; enabled)
Active: active (running) since Wed 2026-07-01 07:56:24 EDT; 5 days ago
Main PID: 16543 (karaf)
Memory: 291.0M
✅ active (running) → エージェントは正常に稼働中！
| 確認ポイント | 内容 |
|---|---|
active (running) |
正常稼働 |
enabled |
OS再起動後も自動起動する設定 |
Main PID: karaf |
Instana AgentはJava(Karaf)ベースで動作 |
systemdサービスとは
OS起動時に自動で起動し、バックグラウンドでずっと監視を続ける。
systemctlで状態確認（status）や再起動（restart）が可能。
③ インストールディレクトリの構造を確認する
cd /opt/instana/agent && ls
LICENSE VERSION etc/ jvm/ lib/ data/
bin/ system/ licenses/
ディレクトリの役割（一部抜粋）
/opt/instana/agent/
├── bin/ ← 起動・停止・状態確認などの実行スクリプト群
├── etc/ ← 設定ファイル群
│ └── instana/ ← Instana agent の主要設定ディレクトリ
├── data/
│ ├── log/ ← エージェントログ
│ └── repo/ ← 実行時アーティファクトの格納領域
├── jvm/ ← JVM 関連ディレクトリ
└── lib/ ← ライブラリ
etc/instana/配下には、諸々の設定ファイル、data/repo/配下には、sensorやdiscoveryなどの実体がありました。
④ 設定ファイルの場所と内容
メイン設定ファイルの場所
/opt/instana/agent/etc/instana/configuration.yaml
# itzuser では Permission Denied → sudo が必要
sudo cat /opt/instana/agent/etc/instana/configuration.yaml
configuration.yaml の主な設定項目
# ホスト・ゾーンのタグ設定
com.instana.plugin.host:
tags:
- 'environment:production'
zone: 'your-zone-name'
# Javaアプリの監視
com.instana.plugin.java:
enabled: true
# Open Liberty の監視
com.instana.plugin.websphereapplicationserver:
enabled: true
# ハードウェアメトリクスの収集
com.instana.plugin.generic.hardware:
enabled: true
おわりに
今回やったことをまとめると：
-
SSH接続のパーミッション問題 →
chmod 600で解決 -
Instana AgentはCLIではなくsystemdサービス →
systemctl statusで確認 -
設定ファイルは
/opt/instana/agent/etc/instana/配下 →configuration.yamlでは、接続先や監視対象・zoneの設定などができる。