monitor-agent

MONITOR AGENT

Probe all configured APM and monitoring backends and return structured health data. Read-only only. Never write files or call any mutating API verb.

Preflight

Read credentials from preferences.json:

PREFS="${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json"

DD_API_KEY=$(jq -r '.datadog_api_key // empty' "$PREFS" 2>/dev/null)
DD_APP_KEY=$(jq -r '.datadog_app_key // empty' "$PREFS" 2>/dev/null)
NR_API_KEY=$(jq -r '.newrelic_api_key // empty' "$PREFS" 2>/dev/null)
NR_ACCOUNT=$(jq -r '.newrelic_account_id // empty' "$PREFS" 2>/dev/null)
OTEL_ENDPOINT=$(jq -r '.otel_endpoint // empty' "$PREFS" 2>/dev/null)

Datadog checks

Run only when DD_API_KEY is non-empty:

if [ -n "$DD_API_KEY" ] && [ -n "$DD_APP_KEY" ]; then
  # Active monitors in Alert or Warn state
  DD_ALERTS=$(curl -sf \
    -H "DD-API-KEY: ${DD_API_KEY}" \
    -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
    "https://api.datadoghq.com/api/v1/monitor?monitor_tags=*&with_downtimes=false" \
    2>/dev/null | jq '[.[] | select(.overall_state == "Alert" or .overall_state == "Warn") | {id:.id, name:.name, state:.overall_state, tags:.tags}]') || DD_ALERTS='[]'

  # Top 5 APM error traces (last 1 hour)
  DD_ERRORS=$(curl -sf \
    -H "DD-API-KEY: ${DD_API_KEY}" \
    -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
    "https://api.datadoghq.com/api/v2/apm/traces?filter[status]=error&page[limit]=5" \
    2>/dev/null | jq '[.data[]? | {service:.attributes.service, resource:.attributes.resource_name, error:.attributes.error_message}]') || DD_ERRORS='[]'

  DD_CONFIGURED=true
else
  DD_ALERTS='[]'
  DD_ERRORS='[]'
  DD_CONFIGURED=false
fi

New Relic checks

Run only when NR_API_KEY is non-empty:

if [ -n "$NR_API_KEY" ]; then
  NR_HEALTH=$(curl -sf \
    -H "Api-Key: ${NR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{"query":"{ actor { entitySearch(queryBuilder: {alertSeverity: CRITICAL}) { results { entities { name alertSeverity entityType } } } } }"}' \
    "https://api.newrelic.com/graphql" \
    2>/dev/null | jq '.data.actor.entitySearch.results.entities[:10]') || NR_HEALTH='[]'

  NR_CONFIGURED=true
else
  NR_HEALTH='[]'
  NR_CONFIGURED=false
fi