# 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

newrelic-cli-diagnostics

Agent Diagnostics

Run Full Diagnostics

Validate Config File