特定 EC2 インスタンスがどの Systems Manager 機能を利用しているか一括で確認できるスクリプトを作ってみた

#!/bin/bash
#
# check-ssm-features.sh
# 指定した EC2 インスタンスがどの Systems Manager 機能を使用しているか一括確認するスクリプト
#
# 使い方:
#   sh ./check-ssm-features.sh <instance-id> [region]
#
# 例:
#   sh ./check-ssm-features.sh i-0123456789 ap-northeast-1
#
# 注意点:
# 本スクリプトは API で取得可能な範囲の確認です。
# タグベースの Maintenance Window ターゲットや Automation の実行履歴等は別途確認が必要です。

set -euo pipefail

INSTANCE_ID="${1:?インスタンスIDを指定してください（例: i-0123456789）}"
REGION="${2:-ap-northeast-1}"

AWS_CMD="aws"
SEPARATOR="$(printf '=%.0s' {1..70})"
FOUND_FEATURES=()

echo "${SEPARATOR}"
echo " Systems Manager 機能利用状況チェック"
echo " インスタンス: ${INSTANCE_ID}"
echo " リージョン:   ${REGION}"
echo " 実行日時:     $(date '+%Y-%m-%d %H:%M:%S')"
echo "${SEPARATOR}"
echo ""

# --- 1. マネージドノード情報 ---
echo "【1. マネージドノード情報 (describe-instance-information)】"
INSTANCE_INFO=$(${AWS_CMD} ssm describe-instance-information \
  --filters "Key=InstanceIds,Values=${INSTANCE_ID}" \
  --region "${REGION}" \
  --output json 2>&1) || true

INSTANCE_COUNT=$(echo "${INSTANCE_INFO}" | jq -r '.InstanceInformationList | length' 2>/dev/null || echo "0")

if [[ "${INSTANCE_COUNT}" -gt 0 ]]; then
  echo "  ✅ SSM マネージドノードとして登録済み"
  echo "${INSTANCE_INFO}" | jq -r '.InstanceInformationList[] | "  - AgentVersion:    \(.AgentVersion // "N/A")\n  - PingStatus:      \(.PingStatus // "N/A")\n  - LastPingTime:    \(.LastPingDateTime // "N/A")\n  - PlatformName:    \(.PlatformName // "N/A")\n  - PlatformVersion: \(.PlatformVersion // "N/A")\n  - IPAddress:       \(.IPAddress // "N/A")\n  - AssociationStatus: \(.AssociationStatus // "N/A")"'
  FOUND_FEATURES+=("SSM Agent")
else
  echo "  ❌ SSM マネージドノードとして登録されていません"
  echo ""
  echo "※ SSM Agent が未インストールまたは未起動の可能性があります。"
  echo "  以降のチェックは正確な結果を返さない場合があります。"
fi
echo ""

# --- 2. State Manager (Association) ---
echo "【2. State Manager - Association】"
ASSOCIATIONS=$(${AWS_CMD} ssm describe-instance-associations-status \
  --instance-id "${INSTANCE_ID}" \
  --region "${REGION}" \
  --output json 2>&1) || true

ASSOC_COUNT=$(echo "${ASSOCIATIONS}" | jq -r '.InstanceAssociationStatusInfos | length' 2>/dev/null || echo "0")

if [[ "${ASSOC_COUNT}" -gt 0 ]]; then
  echo "  ✅ ${ASSOC_COUNT} 件の Association が設定されています"
  echo "${ASSOCIATIONS}" | jq -r '.InstanceAssociationStatusInfos[] | "  - Name: \(.Name // "N/A") | AssociationId: \(.AssociationId // "N/A") | Status: \(.Status // "N/A") | AssociationName: \(.AssociationName // "なし")"'
  FOUND_FEATURES+=("State Manager")
else
  echo "  ➖ Association は設定されていません"
fi
echo ""

# --- 3. Run Command 実行履歴 ---
echo "【3. Run Command - 実行履歴（直近5件）】"
COMMANDS=$(${AWS_CMD} ssm list-commands \
  --instance-id "${INSTANCE_ID}" \
  --max-results 5 \
  --region "${REGION}" \
  --output json 2>&1) || true

CMD_COUNT=$(echo "${COMMANDS}" | jq -r '.Commands | length' 2>/dev/null || echo "0")

if [[ "${CMD_COUNT}" -gt 0 ]]; then
  echo "  ✅ ${CMD_COUNT} 件のコマンド実行履歴があります"
  echo "${COMMANDS}" | jq -r '.Commands[] | "  - CommandId: \(.CommandId) | Document: \(.DocumentName) | Status: \(.Status) | RequestedAt: \(.RequestedDateTime)"'
  FOUND_FEATURES+=("Run Command")
else
  echo "  ➖ コマンド実行履歴はありません"
fi
echo ""

# --- 4. Patch Manager / コンプライアンス ---
echo "【4. Patch Manager / コンプライアンス】"
COMPLIANCE=$(${AWS_CMD} ssm list-compliance-items \
  --resource-ids "${INSTANCE_ID}" \
  --resource-types "ManagedInstance" \
  --region "${REGION}" \
  --output json 2>&1) || true

COMP_COUNT=$(echo "${COMPLIANCE}" | jq -r '.ComplianceItems | length' 2>/dev/null || echo "0")

if [[ "${COMP_COUNT}" -gt 0 ]]; then
  echo "  ✅ ${COMP_COUNT} 件のコンプライアンスアイテムがあります"
  echo ""
  echo "  タイプ別集計:"
  echo "${COMPLIANCE}" | jq -r '[.ComplianceItems[].ComplianceType] | group_by(.) | .[] | "    - \(.[0]): \(length) 件"'
  echo ""
  echo "  ステータス別集計:"
  echo "${COMPLIANCE}" | jq -r '[.ComplianceItems[].Status] | group_by(.) | .[] | "    - \(.[0]): \(length) 件"'
  FOUND_FEATURES+=("Patch Manager/Compliance")
else
  echo "  ➖ コンプライアンスアイテムはありません"
fi
echo ""

# --- 5. Inventory ---
echo "【5. Inventory（収集データ）】"
INVENTORY=$(${AWS_CMD} ssm get-inventory \
  --filters "Key=AWS:InstanceInformation.InstanceId,Values=${INSTANCE_ID},Type=Equal" \
  --region "${REGION}" \
  --output json 2>&1) || true

INV_COUNT=$(echo "${INVENTORY}" | jq -r '.Entities | length' 2>/dev/null || echo "0")

if [[ "${INV_COUNT}" -gt 0 ]]; then
  echo "  ✅ インベントリデータが収集されています"
  INV_SCHEMAS=$(${AWS_CMD} ssm list-inventory-entries \
    --instance-id "${INSTANCE_ID}" \
    --type-name "AWS:Application" \
    --region "${REGION}" \
    --output json 2>&1) || true

  APP_COUNT=$(echo "${INV_SCHEMAS}" | jq -r '.Entries | length' 2>/dev/null || echo "0")
  echo "  - AWS:Application エントリ数: ${APP_COUNT}"

  for INV_TYPE in "AWS:Network" "AWS:WindowsUpdate" "AWS:AWSComponent"; do
    TYPE_RESULT=$(${AWS_CMD} ssm list-inventory-entries \
      --instance-id "${INSTANCE_ID}" \
      --type-name "${INV_TYPE}" \
      --region "${REGION}" \
      --output json 2>&1) || true
    TYPE_COUNT=$(echo "${TYPE_RESULT}" | jq -r '.Entries | length' 2>/dev/null || echo "0")
    echo "  - ${INV_TYPE} エントリ数: ${TYPE_COUNT}"
  done
  FOUND_FEATURES+=("Inventory")
else
  echo "  ➖ インベントリデータは収集されていません"
fi
echo ""

# --- 6. Session Manager ---
echo "【6. Session Manager - セッション履歴（直近10件）】"
SESSIONS=$(${AWS_CMD} ssm describe-sessions \
  --state History \
  --filters "key=Target,value=${INSTANCE_ID}" \
  --max-results 10 \
  --region "${REGION}" \
  --output json 2>&1) || true

SESSION_COUNT=$(echo "${SESSIONS}" | jq -r '.Sessions | length' 2>/dev/null || echo "0")

if [[ "${SESSION_COUNT}" -gt 0 ]]; then
  echo "  ✅ ${SESSION_COUNT} 件のセッション履歴があります"
  echo "${SESSIONS}" | jq -r '.Sessions[] | "  - SessionId: \(.SessionId) | Owner: \(.Owner // "N/A") | StartDate: \(.StartDate) | EndDate: \(.EndDate // "継続中")"'
  FOUND_FEATURES+=("Session Manager")
else
  echo "  ➖ セッション履歴はありません"
fi
echo ""

# --- 7. Maintenance Window ---
echo "【7. Maintenance Window】"
MW_LIST=$(${AWS_CMD} ssm describe-maintenance-windows \
  --region "${REGION}" \
  --output json 2>&1) || true

MW_COUNT=$(echo "${MW_LIST}" | jq -r '.WindowIdentities | length' 2>/dev/null || echo "0")
MW_MATCHED=0

if [[ "${MW_COUNT}" -gt 0 ]]; then
  for MW_ID in $(echo "${MW_LIST}" | jq -r '.WindowIdentities[].WindowId'); do
    TARGETS=$(${AWS_CMD} ssm describe-maintenance-window-targets \
      --window-id "${MW_ID}" \
      --region "${REGION}" \
      --output json 2>&1) || true

    if echo "${TARGETS}" | jq -e ".Targets[] | select(.Targets[]? | select(.Key==\"InstanceIds\" and (.Values[]? == \"${INSTANCE_ID}\")))" > /dev/null 2>&1; then
      MW_NAME=$(echo "${MW_LIST}" | jq -r ".WindowIdentities[] | select(.WindowId==\"${MW_ID}\") | .Name")
      echo "  ✅ Maintenance Window に含まれています: ${MW_NAME} (${MW_ID})"
      MW_MATCHED=$((MW_MATCHED + 1))
    fi

    TAG_TARGETS=$(echo "${TARGETS}" | jq -r '.Targets[] | select(.Targets[]? | select(.Key | startswith("tag:")))' 2>/dev/null || true)
    if [[ -n "${TAG_TARGETS}" ]]; then
      MW_NAME=$(echo "${MW_LIST}" | jq -r ".WindowIdentities[] | select(.WindowId==\"${MW_ID}\") | .Name")
      echo "  ℹ️  タグベースのターゲットあり: ${MW_NAME} (${MW_ID}) ※インスタンスのタグと照合が必要"
    fi
  done

  if [[ "${MW_MATCHED}" -gt 0 ]]; then
    FOUND_FEATURES+=("Maintenance Window")
  else
    echo "  ➖ InstanceId 直接指定の Maintenance Window ターゲットには含まれていません"
    echo "     ※タグベースのターゲットは手動確認が必要です"
  fi
else
  echo "  ➖ Maintenance Window が定義されていません"
fi
echo ""

# --- 8. Distributor ---
echo "【8. Distributor - パッケージインストール履歴】"
DISTRIBUTOR=$(${AWS_CMD} ssm list-commands \
  --instance-id "${INSTANCE_ID}" \
  --filters "key=DocumentName,value=AWS-ConfigureAWSPackage" \
  --max-results 10 \
  --region "${REGION}" \
  --output json 2>&1) || true

DIST_COUNT=$(echo "${DISTRIBUTOR}" | jq -r '.Commands | length' 2>/dev/null || echo "0")

if [[ "${DIST_COUNT}" -gt 0 ]]; then
  echo "  ✅ ${DIST_COUNT} 件の Distributor パッケージ配布履歴があります"
  echo "${DISTRIBUTOR}" | jq -r '.Commands[] | "  - CommandId: \(.CommandId) | Status: \(.Status) | RequestedAt: \(.RequestedDateTime)"'
  FOUND_FEATURES+=("Distributor")
else
  echo "  ➖ Distributor パッケージ配布履歴はありません"
fi
echo ""

# --- サマリー ---
echo "${SEPARATOR}"
echo " サマリー"
echo "${SEPARATOR}"
if [[ ${#FOUND_FEATURES[@]} -gt 0 ]]; then
  echo ""
  echo "  利用が確認された SSM 機能:"
  for feature in "${FOUND_FEATURES[@]}"; do
    echo "    ✅ ${feature}"
  done
else
  echo ""
  echo "  利用が確認された SSM 機能はありませんでした。"
fi
echo ""
echo "${SEPARATOR}"