はじめに

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の設定などができる。