newrelic-ops

Files (1)

• SKILL.md

SKILL.md (first lines)

# New Relic Operations

Call New Relic NerdGraph (GraphQL) and REST v2 APIs directly via `curl`. No MCP server or Python dependencies needed.

## Prerequisites

Two environment variables must be set:
- `NEW_RELIC_API_KEY` — User API key (starts with `NRAK-`)
- `NEW_RELIC_ACCOUNT_ID` — Numeric account ID

Before the first API call in a session, verify they exist:
```bash
test -n "$NEW_RELIC_API_KEY" && test -n "$NEW_RELIC_ACCOUNT_ID" && echo "OK" || echo "MISSING: set NEW_RELIC_API_KEY and NEW_RELIC_ACCOUNT_ID"
```

If missing, ask the user to set them. Do NOT proceed without them.

## API Endpoints

| API | Endpoint | Auth Header |
|-----|----------|-------------|
| NerdGraph (GraphQL) US | `https://api.newrelic.com/graphql` | `API-Key: $NEW_RELIC_API_KEY` |
| NerdGraph (GraphQL) EU | `https://api.eu.newrelic.com/graphql` | `API-Key: $NEW_RELIC_API_KEY` |
| REST v2 US | `https://api.newrelic.com/v2/` | `Api-Key: $NEW_RELIC_API_KEY` |

Default to US endpoints. If the user mentions EU region, switch to EU endpoints.

## Core Operations

### 1. Run NRQL Query (most common)

```bash
curl -s -X POST https://api.newrelic.com/graphql \
  -H 'Content-Type: application/json' \
  -H "API-Key: $NEW_RELIC_API_KEY" \
  -d "{\"query\": \"{ actor { account(id: $NEW_RELIC_ACCOUNT_ID) { nrql(query: \\\"SELECT count(*) FROM Transaction SINCE 1 HOUR AGO\\\") { results } } } }\"}" \
  | python3 -m json.tool
```

Replace the NRQL inside `\\\"...\\\"` with the user's query.

**Common NRQL event types:**

| Event Type | Data |
|-----------|------|
| `Transaction` | APM request data (duration, status, name) |
| `TransactionError` | Errors with stack traces |
| `Log` | Log entries |
| `SystemSample` | Host CPU/memory/disk |
| `Metric` | Dimensional metrics |
| `SyntheticCheck` | Synthetic monitor results |
| `NrAiIncident` | Alert incidents |
| `Deployment` | Change tracking events |

**NRQL essentials:**
- Always include a time range: `SINCE 1 hour ago`, `SINCE 1 day ago`
- Use `FACET` for grouping: `FACET appName`, `FACET host`
- Use `TIMESERIES` for trends over time
- Use `LIMIT` to control result size (default 10)
- Use `WHERE error IS TRUE` to filter errors
- Use `COMPARE WITH 1 hour ago` to compare periods

### 2. Search Entities (apps, hosts, dashboards)

```bash
curl -s -X POST https://api.newrelic.com/graphql \
  -H 'Content-Type: application/json' \
  -H "API-Key: $NEW_RELIC_API_KEY" \
  -d '{"query": "{ actor { entitySearch(queryBuilder: {domain: APM, type: APPLICATION}) { results { entities { name entityType guid accountId alertSeverity reporting } nextCursor } } } }"}' \
  | python3 -m json.tool
```

**Domain/Type combinations:**

| Domain | Type | What |
|--------|------|------|
| `APM` | `APPLICATION` | APM applications |
| `INFRA` | `HOST` | Infrastructure hosts |
| `BROWSER` | `APPLICATION` | Browser apps |
| `MOBILE` | `APPLICATION` | Mobile apps |
| `VIZ` | `DASHBOARD` | Dashboards |
| `SYNTH` | `MONITOR` | Synthetic monitors |

**Search by name (freeform):**
```bash
curl -s -X POST https://api.newrelic.com/graphql \
  -H 'Content-Type: application/json' \
  -H "API-Key: $NEW_RELIC_API_KEY" \
  -d "{\"query\": \"{ actor { entitySearch(query: \\\"name LIKE 'SERVICE_NAME' AND domain = 'APM'\\\") { count results { entities { name guid entityType alertSeverity } } } } }\"}" \
  | python3 -m json.tool
```

### 3. Get Entity Details by GUID

```bash
curl -s -X POST https://api.newrelic.com/graphql \
  -H 'Content-Type: application/json' \
  -H "API-Key: $NEW_RELIC_API_KEY" \
  -d '{"query": "{ actor { entity(guid: \"ENTITY_GUID_HERE\") { name entityType alertSeverity ... on ApmApplicationEntityOutline { apmSummary { errorRate apdexScore webResponseTimeAverage responseTimeAverage throughput hostCount instanceCount } } } } }"}' \
  | python3 -m json.tool
```

### 4. Get Active Alerts

**Via REST v2 (simpler):**
```bash
curl -s -X GET 'https://api.newrelic.com/v2/alerts_violations.json?only_open=true' \
  -H "Api-Key: $NEW_RELIC_API_KEY" \
  | python3 -m json.tool
```

**Via NRQL (more flexible):**
```bash
curl -s -X POST https://api.newrelic.com/graphql \
  -H 'Content-Type: application/json' \
  -H "API-Key: $NEW_RELIC_API_KEY" \
  -d "{\"query\": \"{ actor { account(id: $NEW_RELIC_ACCOUNT_ID) { nrql(query: \\\"SELECT * FROM NrAiIncident WHERE event = 'open' SINCE 1 day ago LIMIT 50\\\") { results } } } }\"}" \
  | python3 -m json.tool
```

From Ivlad003/plugins, MIT.

More from Ivlad003/plugins