How do I install the Newrelic CLI Diagnostics skill?

Run npx skillmds@latest add kilo-org/newrelic-cli-diagnostics in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Newrelic CLI Diagnostics safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Newrelic CLI Diagnostics?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Newrelic CLI Diagnostics free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Newrelic CLI Diagnostics?

Kilo-Org (@kilo-org) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Newrelic CLI Diagnostics by kilo-org

Name: Newrelic CLI Diagnostics
Author: Kilo-Org

Newrelic CLI Diagnostics

This subskill should be used when diagnosing New Relic agent configuration, API connectivity, profile authentication, or missing telemetry with the New Relic CLI. Use the parent newrelic-cli-skills skill for setup and routing.

Kilo-Org e960da7 2.7 KB Updated Sep 17, 2026

File contents

Agent Diagnostics

Validate New Relic agent configuration, connectivity, and reporting status.

Run Full Diagnostics

newrelic diagnose run

Checks: API key validity, account connectivity, agent config files, log paths, proxy settings.

Validate Config File

# For .NET agent on Windows
newrelic diagnose validate \
  --config "C:\ProgramData\New Relic\.NET Agent\newrelic.config"

# For Linux
newrelic diagnose validate --config /etc/newrelic/newrelic.yml

Check Agent is Reporting

# Verify an app is actively sending data
newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID --query "
  SELECT count(*)
  FROM Transaction
  WHERE appName = 'my-app'
  SINCE 10 minutes ago
"
# count = 0 means agent is not reporting

# Check entity reporting status
newrelic entity search --name "my-app" --type APPLICATION --domain APM | \
  jq '.[] | {name, reporting}'

Check Agent Version

newrelic entity search --name "my-app" --type APPLICATION --domain APM | \
  jq '.[] | {name, tags: (.tags[] | select(.key == "agentVersion"))}'

Connectivity Test

# Test API key and account access
newrelic profile list
newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \
  --query "SELECT count(*) FROM NrIntegrationError SINCE 1 hour ago"

If NrIntegrationError count > 0, data ingestion has issues.

Common Issues

Symptom	Likely Cause	Fix
App shows `reporting: false`	Agent stopped or config missing	Restart app pool / check agent logs
Transaction count = 0	IIS app pool recycled without agent init	Ensure agent auto-instruments on startup
High `NrIntegrationError`	Data too large or malformed	Check agent logs for serialization errors
`alertSeverity: NOT_CONFIGURED`	No alert conditions on the entity	Add NRQL or APM metric conditions

.NET Agent Specific (Windows/IIS)

# Check which apps are instrumented on a host
newrelic entity search --name "my-host" --type HOST | \
  jq '.[] | .tags[] | select(.key == "apmApplicationNames")'

# Agent logs location (Windows)
# C:\ProgramData\New Relic\.NET Agent\Logs\

Profile Management

# List all profiles
newrelic profile list

# Switch profile
newrelic profile default --profile production

# Add a new profile
newrelic profile add \
  --profile staging \
  --apiKey $NEW_RELIC_API_KEY \
  --accountId $NEW_RELIC_ACCOUNT_ID \
  --region US

---name: newrelic-cli-diagnosticsdescription: This subskill should be used when diagnosing New Relic agent configuration, API connectivity, profile authentication, or missing telemetry with the New Relic CLI. Use the parent newrelic-cli-skills skill for setup and routing.---# Agent DiagnosticsValidate New Relic agent configuration, connectivity, and reporting status.---## Run Full Diagnostics```bashnewrelic diagnose run```Checks: API key validity, account connectivity, agent config files, log paths, proxy settings.---## Validate Config File```bash# For .NET agent on Windowsnewrelic diagnose validate \ --config "C:\ProgramData\New Relic\.NET Agent\newrelic.config"# For Linuxnewrelic diagnose validate --config /etc/newrelic/newrelic.yml```---## Check Agent is Reporting```bash# Verify an app is actively sending datanewrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID --query " SELECT count(*) FROM Transaction WHERE appName = 'my-app' SINCE 10 minutes ago"# count = 0 means agent is not reporting# Check entity reporting statusnewrelic entity search --name "my-app" --type APPLICATION --domain APM | \ jq '.[] | {name, reporting}'```---## Check Agent Version```bashnewrelic entity search --name "my-app" --type APPLICATION --domain APM | \ jq '.[] | {name, tags: (.tags[] | select(.key == "agentVersion"))}'```---## Connectivity Test```bash# Test API key and account accessnewrelic profile listnewrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \ --query "SELECT count(*) FROM NrIntegrationError SINCE 1 hour ago"```If `NrIntegrationError` count > 0, data ingestion has issues.---## Common Issues| Symptom | Likely Cause | Fix ||---|---|---|| App shows `reporting: false` | Agent stopped or config missing | Restart app pool / check agent logs || Transaction count = 0 | IIS app pool recycled without agent init | Ensure agent auto-instruments on startup || High `NrIntegrationError` | Data too large or malformed | Check agent logs for serialization errors || `alertSeverity: NOT_CONFIGURED` | No alert conditions on the entity | Add NRQL or APM metric conditions |---## .NET Agent Specific (Windows/IIS)```bash# Check which apps are instrumented on a hostnewrelic entity search --name "my-host" --type HOST | \ jq '.[] | .tags[] | select(.key == "apmApplicationNames")'# Agent logs location (Windows)# C:\ProgramData\New Relic\.NET Agent\Logs\```---## Profile Management```bash# List all profilesnewrelic profile list# Switch profilenewrelic profile default --profile production# Add a new profilenewrelic profile add \ --profile staging \ --apiKey $NEW_RELIC_API_KEY \ --accountId $NEW_RELIC_ACCOUNT_ID \ --region US```

Frequently asked questions