New Relic#

Monitor applications, infrastructure, logs, synthetic checks, and cloud services in New Relic at scale. Configure alert policies and conditions, manage dashboards, query telemetry data with NRQL, set up synthetic monitors, manage workloads, configure notification channels, and track deployments.

This skill uses ClawLink for hosted connection flows and credentials so you do not need to configure New Relic API access yourself.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect New RelicApp-specific connection GIF coming soon

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   New Relic NerdGraph │
│   (User Chat)   │     │   (GraphQL)  │     │   API (GraphQL)      │
└─────────────────┘     └──────────────┘     └──────────────────────┘
         │                       │                       │
         │  1. Install Plugin  │                       │
         │  2. Pair Device     │                       │
         │  3. Connect New Relic│                       │
         │                   │  4. Secure Token        │
         │                   │  5. Proxy Requests      │
         │                   │                         │
         ▼                   ▼                         ▼
   ┌──────────┐      ┌──────────┐           ┌──────────┐
   │  SKILL   │      │ Dashboard│           │ New Relic│
   │  File    │      │ Auth      │           │ Account  │
   └──────────┘      └──────────┘           └──────────┘

Install#

Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Then tell the user: "OpenClaw has been restarted. Send /new as a standalone message to start a fresh chat, then ask for New Relic again."

Quick Start#

bash

# Query telemetry data
clawlink_call_tool --tool "new_relic_execute_nrql_query" \
  --params '{"nrql": "SELECT * FROM Metric TIMESERIES"}'

# List alert policies
clawlink_call_tool --tool "new_relic_get_alert_policies" --params '{}'

# Search entities
clawlink_call_tool --tool "new_relic_search_entities" \
  --params '{"name": "my-app", "type": "APPLICATION"}'

Authentication#

All New Relic tool calls are authenticated automatically by ClawLink using the user's connected New Relic account.

No API key is required in chat. ClawLink stores the API key securely and injects it into every New Relic NerdGraph request on the user's behalf.

Getting Connected#

1. Install the ClawLink plugin (see Install above).
2. Pair the plugin with clawlink_begin_pairing if it is not configured yet.
3. Open https://claw-link.dev/dashboard?add=new-relic and connect New Relic (requires an active New Relic account).
4. Call clawlink_list_integrations to verify the connection is active.

Connection Management#

List Connections#

bash

clawlink_list_integrations

Response: Returns all connected integrations. Look for new-relic in the list.

Verify Connection#

bash

clawlink_list_tools --integration new-relic

Response: Returns the live tool catalog for New Relic.

Reconnect#

If New Relic tools are missing or the connection shows an error:

1. Direct the user to https://claw-link.dev/dashboard?add=new-relic
2. After they confirm, call clawlink_list_integrations to verify
3. Then call clawlink_list_tools --integration new-relic

Security & Permissions#

• Access is scoped to the connected New Relic account only.
• All write operations require explicit user confirmation. Before executing any alert, dashboard, or policy action, confirm the target resource and intended effect with the user.
• Destructive actions (delete entity, delete dashboard, delete policy, delete user) are marked as high-impact and must be confirmed.
• User management operations require authentication domain ID and appropriate permissions.
• API key management requires the key ID (not the actual key value).
• Golden metrics/tags reset restores New Relic defaults and cannot be undone.
• Dashboard deletion can be recovered via new_relic_undelete_dashboard but custom tags are lost.

Tool Reference#

NRQL Queries & Data#

ToolDescriptionModenew_relic_execute_nrql_queryExecute NRQL queries for telemetry data — supports sync and async modes (async for queries over 5 seconds)Readnew_relic_query_errorQuery error data using custom NRQL via NerdGraphReadnew_relic_query_example_read_queryExecute GraphQL read queries against NerdGraph APIRead

Entity Management#

ToolDescriptionModenew_relic_search_entitiesSearch for entities by name, type, domain, and other attributes — returns GUID, tags, metadata; supports pagination (200/page)Readnew_relic_create_entity_relationshipCreate or replace a user-defined relationship between entities (BUILT_FROM, CALLS, CONTAINS, etc.)Writenew_relic_delete_entityDelete APM-APPLICATION, EXT-SERVICE, or REF-REPOSITORY entitiesWritenew_relic_delete_entity_relationship_user_definedDelete user-defined relationships between entitiesWritenew_relic_add_tags_to_entityAdd tags with values to an entity (APM agents may require restart for new tags)Writenew_relic_replace_tags_on_entityReplace all tags on an entity with a new set (removes existing tags)Writenew_relic_delete_tag_values_from_entityDelete specific tag values from an entityWritenew_relic_remove_entity_conditionRemove an entity from an alert condition (condition must retain at least one entity)Writenew_relic_delete_agent_applicationDelete an APM application entity (requires app has not reported data for 12+ hours)Writenew_relic_update_agent_application_settingsUpdate APM agent application settings (e.g., enable/disable server-side config)Write

Golden Metrics & Tags#

ToolDescriptionModenew_relic_override_entity_golden_metricsOverride golden metrics for an entity type or workload (pass empty array to reset)Writenew_relic_override_entity_golden_tagsConfigure golden tags for entity types in the New Relic UIWritenew_relic_reset_entity_golden_metricsReset custom golden metrics and golden tags to New Relic defaultsWritenew_relic_reset_entity_golden_tagsReset golden tags for entities to New Relic defaultsWrite

Applications & APM#

ToolDescriptionModenew_relic_get_applicationsList all applications with optional name, host, or ID filteringReadnew_relic_get_app_metric_dataGet metric timeslice data for an application (call_count, average_response_time, etc.)Readnew_relic_get_app_metrics_namesList available metric names for an applicationReadnew_relic_create_deployment_markerRecord a deployment marker in New Relic UI charts to correlate changes with performanceWritenew_relic_list_deploymentsList all past deployments for an applicationRead

Browser & Mobile Monitoring#

ToolDescriptionModenew_relic_get_browser_applicationsList browser applicationsReadnew_relic_fetch_browser_configurationGet browser application JavaScript configuration and script snippet for embeddingReadnew_relic_fetch_browser_java_script_snippetGet the JavaScript loader snippet for browser monitoringReadnew_relic_update_browser_settingsUpdate browser agent settings (e.g., pin agent version, change loader type)Writenew_relic_create_example_browser_applicationCreate a new browser application for monitoringWritenew_relic_list_mobile_applicationsList all mobile applicationsReadnew_relic_get_mobile_applicationGet mobile app details including crash count and crash rateReadnew_relic_get_mobile_application_metricsList available metric names for a mobile applicationReadnew_relic_get_mobile_metric_dataGet mobile app metric data including crash statisticsReadnew_relic_fetch_mobile_application_tokenRetrieve the application token for mobile app authenticationReadnew_relic_update_mobile_settings_exampleUpdate mobile crash reporting or network monitoring settingsWritenew_relic_create_example_mobile_applicationCreate a new mobile application for monitoringWrite

Dashboards#

ToolDescriptionModenew_relic_get_dashboard_entity_queryGet dashboard configuration, pages, widgets, owner info by GUIDReadnew_relic_create_dashboardCreate a new dashboard with widgets, pages, and visualizations (supports markdown, NRQL, various chart types)Writenew_relic_update_dashboardUpdate a dashboard by GUID — include all pages/widgets with IDs to preserve themWritenew_relic_update_dashboard_pageUpdate a dashboard page — include all existing widgets with IDs to preserve themWritenew_relic_add_widgets_to_dashboard_pageAdd widgets (line charts, area charts, bar charts, tables) to a dashboard pageWritenew_relic_update_dashboard_widgets_in_pageUpdate widget configurations within a dashboard pageWritenew_relic_create_dashboard_snapshot_urlGenerate a shareable snapshot URL of a dashboard at current stateWritenew_relic_update_dashboard_live_url_creation_policiesEnable or disable public live URL creation for dashboards (Authentication Domain Managers only)Writenew_relic_delete_dashboardPermanently delete a dashboard by entity GUIDWritenew_relic_undelete_dashboardRecover a previously deleted dashboard (custom tags cannot be recovered)Write

Alert Policies#

ToolDescriptionModenew_relic_get_alert_policiesList alert policies with optional filtering and paginationReadnew_relic_get_alert_conditionsGet alert conditions for a specified policyReadnew_relic_get_alert_channelsList alert notification channels with IDs, names, types, configurationsReadnew_relic_create_alert_policyCreate a new alert policy container for conditionsWritenew_relic_create_alerts_policy_graphqlCreate an alert policy via NerdGraph GraphQLWritenew_relic_update_alert_policyUpdate an alert policy's name or incident preference via NerdGraphWritenew_relic_update_alert_policy_restUpdate an alert policy via REST API v2Writenew_relic_delete_alert_policyDelete an alert policy via REST APIWritenew_relic_delete_alerts_policy_via_graphqlDelete an alert policy via NerdGraph GraphQLWritenew_relic_update_policy_channelsAssociate notification channels with an alert policy (replaces existing associations)Writenew_relic_delete_policy_channelRemove a notification channel from an alert policyWrite

Alert Conditions#

ToolDescriptionModenew_relic_create_alerts_nrql_condition_staticCreate a static NRQL alert condition with threshold-based alerting, signal loss detection, gap fillingWritenew_relic_create_nrql_baseline_conditionCreate a NRQL baseline alert condition using ML-based anomaly detectionWritenew_relic_create_nrql_conditionCreate a NRQL alert condition for a specified policyWritenew_relic_create_external_service_conditionCreate an external service alert condition for APM external callsWritenew_relic_create_infra_conditionCreate an infrastructure alert condition (CPU, memory, disk, process monitoring)Writenew_relic_create_location_failure_conditionCreate a location failure alert condition for synthetic monitorsWritenew_relic_create_synthetics_alert_conditionCreate a synthetics alert condition for synthetic monitor failuresWritenew_relic_list_nrql_conditionsList NRQL alert conditions for a policyReadnew_relic_list_external_service_conditionsList external service alert conditions for a policyReadnew_relic_list_infra_conditionsList infrastructure alert conditions for a policyReadnew_relic_list_location_failure_conditionsList location failure alert conditions for a policyReadnew_relic_list_synthetics_conditionsList synthetics alert conditions for a policyReadnew_relic_get_infra_conditionGet details for a specific infrastructure alert conditionReadnew_relic_update_nrql_conditionUpdate an existing NRQL alert conditionWritenew_relic_update_nrql_baseline_conditionUpdate a NRQL baseline alert conditionWritenew_relic_update_nrql_static_conditionUpdate a NRQL static alert conditionWritenew_relic_update_external_service_conditionUpdate an external service alert conditionWritenew_relic_update_infra_conditionUpdate an infrastructure alert conditionWritenew_relic_update_location_failure_conditionUpdate a location failure alert conditionWritenew_relic_update_synthetics_alert_conditionUpdate a synthetics alert conditionWritenew_relic_delete_alerts_conditionDelete an alert condition by account ID and condition IDWritenew_relic_delete_nrql_conditionDelete a NRQL alert condition via REST APIWritenew_relic_delete_external_service_conditionDelete an external service alert conditionWritenew_relic_delete_infra_conditionDelete an infrastructure alert conditionWritenew_relic_delete_location_failure_conditionDelete a location failure alert condition via REST APIWritenew_relic_delete_synthetics_conditionDelete a synthetics alert conditionWrite

Alert Notification Channels#

ToolDescriptionModenew_relic_get_alert_channelsList all alert notification channels (email, Slack, webhook, PagerDuty, etc.)Readnew_relic_create_alert_channelCreate an alert notification channel endpointWritenew_relic_update_alert_channelUpdate an existing alert notification channelWritenew_relic_delete_alert_channelDelete an alert notification channel via REST APIWritenew_relic_add_notification_channels_to_policyAdd notification channels to an alert policy via NerdGraphWritenew_relic_remove_notification_channels_from_policyRemove notification channels from an alert policyWrite

AI Notifications (Applied Intelligence)#

ToolDescriptionModenew_relic_create_ai_notifications_channelCreate an AI notification channel (requires pre-existing destination)Writenew_relic_update_ai_notifications_channelUpdate an AI notification channel's name or active statusWritenew_relic_delete_ai_notifications_channelDelete an AI notifications channelWritenew_relic_create_ai_notifications_destinationCreate an AI notifications destination (Jira, ServiceNow, etc.)Writenew_relic_update_ai_notifications_destinationUpdate an AI notifications destination (partial update supported)Writenew_relic_delete_ai_notifications_destinationDelete an AI notifications destination by IDWritenew_relic_create_ai_workflowCreate an AI workflow for automated incident response with filters and enrichmentsWritenew_relic_update_workflowUpdate an existing AI workflow (partial update — only include changed fields)Writenew_relic_test_ai_notification_destination_by_idTest an AI notification destination by IDWritenew_relic_test_ai_notifications_destinationTest an AI notifications destination (supports EMAIL, WEBHOOK types)Writenew_relic_test_ai_notifications_channelTest an AI notifications channel configurationWritenew_relic_test_notification_channelTest a notification channel by sending a test notificationWrite

Synthetic Monitors#

ToolDescriptionModenew_relic_list_monitorsList all synthetic monitors with paginationReadnew_relic_get_synth_monitorGet details for a specific synthetic monitor by IDReadnew_relic_create_monitorCreate a synthetic monitor (legacy synthetics runtime only)Writenew_relic_create_simple_monitorCreate a ping monitor for URL/endpoint availability from multiple locationsWritenew_relic_create_scripted_monitorCreate a scripted browser or API monitor for automated testingWritenew_relic_update_synth_monitorFully replace a synthetic monitor configuration (all fields required)Writenew_relic_update_synthetics_simple_monitorUpdate a ping monitor's name, status, period, URI, locationsWritenew_relic_update_scripted_monitorUpdate a scripted monitor's configuration, script content, or statusWritenew_relic_patch_monitorPartially update individual monitor attributes (only provide fields to change)Writenew_relic_update_monitor_scriptUpdate the script for a SCRIPT_BROWSER or SCRIPT_API monitor (base64-encoded)Writenew_relic_delete_monitorPermanently delete a synthetic monitor by IDWritenew_relic_delete_synthetics_monitor_graphqlDelete a synthetic monitor by entity GUID via NerdGraphWrite

Synthetic Infrastructure#

ToolDescriptionModenew_relic_list_locationsList all available public and private synthetic monitor locationsReadnew_relic_create_synthetics_private_locationCreate a private location for synthetic monitoring from own infrastructureWritenew_relic_delete_synthetics_private_locationDelete a synthetics private locationWritenew_relic_create_broken_links_monitorCreate a broken links monitor that scans a webpage for broken linksWrite

Secure Credentials#

ToolDescriptionModenew_relic_list_secure_credentialsList all secure credentials (actual values never returned — only metadata)Readnew_relic_get_secure_credentialGet a specific secure credential by key (value not returned for security)Readnew_relic_create_secure_credentialAdd a secure credential for use in synthetic monitorsWritenew_relic_create_synthetics_secure_credentialCreate a secure credential in SyntheticsWritenew_relic_update_secure_credentialUpdate a secure credential's value or descriptionWritenew_relic_delete_secure_credentialDelete a secure credential from SyntheticsWritenew_relic_delete_synthetics_secure_credentialDelete a secure credential used in synthetic monitors via NerdGraphWrite

Service Levels#

ToolDescriptionModenew_relic_create_service_levelCreate an SLI with optional SLO objectivesWritenew_relic_update_service_levelUpdate SLI/SLO targets, time windows, event definitions (partial update)Write

Workloads#

ToolDescriptionModenew_relic_update_workloadUpdate a workload's name, entity membership (GUIDs or dynamic queries), or scope accountsWritenew_relic_duplicate_workloadDuplicate an existing workload with optionally a new nameWritenew_relic_delete_workloadPermanently delete a workload by GUIDWrite

Cloud Integrations#

ToolDescriptionModenew_relic_query_cloud_providersList cloud integration providers (AWS, GCP, Azure) configured for an accountReadnew_relic_link_cloud_accountLink a cloud provider account (AWS, Azure, GCP) to New Relic for monitoringWritenew_relic_rename_cloud_accountRename a linked cloud provider account's display nameWritenew_relic_configure_cloud_integrationEnable and configure monitoring for AWS, Azure, or GCP services (account must be linked first)Writenew_relic_disable_cloud_integrationDisable (remove) a cloud integration for a linked accountWrite

Log Data Partition#

ToolDescriptionModenew_relic_create_log_data_partition_ruleCreate a log data partition rule to route logs to specific partitionsWritenew_relic_update_data_partition_ruleUpdate a log data partition rule's description, NRQL criteria, or enabled state (partial update)Writenew_relic_delete_data_partition_ruleDelete a log data partition rule (existing partitioned data is retained per retention policy)Write

Lookup Tables#

ToolDescriptionModenew_relic_list_lookup_tablesList all lookup tables with names, GUIDs, sizes, and last update detailsReadnew_relic_get_lookup_tableDownload a lookup table's metadata and optionally contentsReadnew_relic_create_lookup_tableUpload a new lookup table to enrich telemetry data in NRQL queriesWritenew_relic_update_lookup_tableReplace an existing lookup table (complete replacement of structure and data)Writenew_relic_delete_lookup_tableDelete a lookup table from the accountWrite

Metric Normalization#

ToolDescriptionModenew_relic_create_metric_normalization_ruleCreate a metric normalization rule to replace patterns, ignore metrics, or prevent new metricsWritenew_relic_edit_metric_normalization_ruleUpdate a metric normalization rule's match expression, action, enabled state, or replacement patternWritenew_relic_enable_metric_normalization_ruleReactivate a previously disabled metric normalization ruleWritenew_relic_disable_metric_normalization_ruleDeactivate a metric normalization rule without deleting itWrite

Telemetry Ingestion#

ToolDescriptionModenew_relic_send_eventsSend custom event data to New Relic Event API (queryable via NRQL)Writenew_relic_send_tracesSend distributed tracing span data to New Relic for latency monitoringWrite

Key Transactions#

ToolDescriptionModenew_relic_list_key_transactionsList all key transactions or filter by name or IDsRead

Users & Access#

ToolDescriptionModenew_relic_create_userCreate a new user in an authentication domain (requires domain ID, email, name, user type tier)Writenew_relic_update_userUpdate a user's email or access tier (requires user ID and at least one field)Writenew_relic_delete_user_management_userDelete a user from the New Relic accountWritenew_relic_revoke_authorization_accessRevoke specific role assignments from a group for one or more accountsWritenew_relic_update_cross_account_electionsEnable or disable cross-account alerting for specific accountsWrite

API Access Keys#

ToolDescriptionModenew_relic_create_api_access_keysCreate user API keys or ingest keys (BROWSER or LICENSE types — max 1,000 per type per account)Writenew_relic_update_api_access_keysUpdate an API key's name or notes (requires key ID, not the actual key value)Writenew_relic_delete_api_access_keysPermanently delete API keys (deleted keys no longer grant access)Write

Account Management#

ToolDescriptionModenew_relic_update_accountUpdate a New Relic account name via NerdGraphWritenew_relic_fetch_your_org_idGet the organization ID and name for the authenticated userReadnew_relic_fetch_rules_collectionGet rules/elements associated with a scorecard collection (pagination supported)Read

Alerts Violations#

ToolDescriptionModenew_relic_get_alerts_violations_jsonGet alert violations with optional filtering by date range and open statusRead

Code Examples#

Execute a NRQL query#

bash

clawlink_call_tool --tool "new_relic_execute_nrql_query" \
  --params '{"nrql": "SELECT average(responseTime), count(*) FROM PageView TIMESERIES 1 hour"}'

List alert policies#

bash

clawlink_call_tool --tool "new_relic_get_alert_policies" \
  --params '{}'

Search for an entity#

bash

clawlink_call_tool --tool "new_relic_search_entities" \
  --params '{"name": "my-service", "type": "APPLICATION"}'

Create a dashboard#

bash

clawlink_call_tool --tool "new_relic_create_dashboard" \
  --params '{"name": "My Dashboard", "pages": [{"name": "Overview", "widgets": []}]}'

Send a custom event#

bash

clawlink_call_tool --tool "new_relic_send_events" \
  --params '{"events": [{"eventType": "MyEvent", "userId": "12345", "action": "signup"}]}'

Discovery Workflow#

1. Call clawlink_list_integrations to confirm New Relic is connected.
2. Call clawlink_list_tools --integration new-relic to see the live catalog.
3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.
4. If the user describes a capability but the exact tool is unclear, call clawlink_search_tools with a short query and integration new-relic.
5. If no New Relic tools appear, direct the user to https://claw-link.dev/dashboard?add=new-relic.

Execution Workflow#

text

┌─────────────────────────────────────────────────────────────┐
│  READ OPERATIONS (Safe)                                     │
│  list → get → search → describe → call                      │
│                                                             │
│  Example: List alert policies → Get conditions → Show      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  WRITE OPERATIONS (Require Confirmation)                     │
│  list → get → describe → preview → confirm → call          │
│                                                             │
│  Example: Preview alert create → User approves → Execute    │
└─────────────────────────────────────────────────────────────┘

1. For unfamiliar tools, ambiguous requests, or any write action, call clawlink_describe_tool first.
2. Use the returned guidance, schema, whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.
4. For writes or anything marked as requiring confirmation, call clawlink_preview_tool first.
5. Execute with clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.

Notes#

• New Relic uses NerdGraph (GraphQL) for most operations — both REST API v2 and GraphQL are supported for alert policies.
• Dashboard updates require including all existing pages/widgets with their GUIDs to preserve them — omitting them removes them.
• Lookup tables enrich telemetry data and can be joined in NRQL queries.
• Metric normalization rules help consolidate similar metrics and reduce cardinality.
• Secure credential values are never returned by the API for security reasons.
• APM agent tag changes may require agent restart to take effect.
• Entity deletion requires the entity to not have reported data for at least 12 hours.
• Cross-account alerting must be enabled per account via update_cross_account_elections.
• NRQL queries over 5 seconds should use async_execution mode or increased timeout.

Error Handling#

Status / ErrorMeaningTool not foundThe tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration new-relic.Missing connectionNew Relic is not connected. Direct the user to https://claw-link.dev/dashboard?add=new-relic.Permission errorThe authenticated user lacks permission for this operation.Entity not foundThe entity GUID does not exist. Verify with new_relic_search_entities.Policy not foundThe alert policy ID does not exist. Verify with new_relic_get_alert_policies.Write rejectedUser did not confirm a write action. Always confirm before executing writes.High-impact actionDestructive action requires explicit user confirmation before execution.Dashboard update missing GUIDsWhen updating a dashboard, all existing pages/widgets must be included with their GUIDs or they will be removed.

Troubleshooting: Tools Not Visible#

1. Check that the ClawLink plugin is installed: bash

   openclaw plugins list
   
   

2. If the plugin is installed but tools are missing, tell the user to send /new as a standalone message to reload the catalog.

3. If a fresh chat does not help, run: bash

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   
   

4. After restart, tell the user to send /new again and retry.

Resources#

• New Relic NerdGraph API Reference
• New Relic NRQL Reference
• New Relic Alert Policies
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=new-relic-observability
• ClawLink Docs: https://docs.claw-link.dev/openclaw
• ClawLink Verification: https://claw-link.dev/verify

Related Skills#

• Kibana Observability — For Kibana log and metrics management
• Make Automation — For Make.com scenario management

---

Powered by ClawLink — an integration hub for OpenClaw