Use New Relic through NerdGraph to query telemetry with NRQL, search monitored entities by name, type, tags, alert state, or reporting status, and retrieve basic metadata by entity GUID.
Record deployment changes with a version, changelog, commit, build links, group IDs, and user context to relate releases to telemetry. Configure the account and credentials required by the action.
Use the block
Run NRQL queries, search monitored entities, fetch entity details, and record deployment change events.
Actions
New Relic NRQL Query
Run a NRQL query against a New Relic account using NerdGraph.
Input
Output
| Parameter | Type | Description |
|---|---|---|
results | array | NRQL result rows. Row fields depend on the query projection. |
resultCount | number | Number of NRQL result rows returned |
New Relic Search Entities
Search New Relic entities by name, GUID, domain type, tags, or reporting state.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | New Relic user API key for NerdGraph |
region | string | No | New Relic data center region: us or eu |
query | string | Yes | Entity search query, for example: name like "api" or domainType = "APM-APPLICATION" |
cursor | string | No | Pagination cursor from a previous entity search |
Output
| Parameter | Type | Description |
|---|---|---|
count | number | Total number of entities matching the query |
query | string | Entity search query New Relic executed |
entities | array | Matching New Relic entities |
↳ guid | string | Entity GUID |
↳ name | string | Entity name |
↳ entityType | string | Entity type |
↳ domain | string | Entity domain, e.g. APM, INFRA |
↳ reporting | boolean | Whether the entity is currently reporting data |
↳ alertSeverity | string | Current alert severity for the entity |
↳ tags | array | Entity tags |
↳ key | string | Tag key |
↳ values | array | Tag values |
nextCursor | string | Cursor for the next page of results |
New Relic Get Entity
Fetch a New Relic entity by GUID.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | New Relic user API key for NerdGraph |
region | string | No | New Relic data center region: us or eu |
guid | string | Yes | Entity GUID |
Output
| Parameter | Type | Description |
|---|---|---|
entity | object | New Relic entity details |
↳ guid | string | Entity GUID |
↳ name | string | Entity name |
↳ entityType | string | Entity type |
↳ domain | string | Entity domain, e.g. APM, INFRA |
↳ reporting | boolean | Whether the entity is currently reporting data |
↳ alertSeverity | string | Current alert severity for the entity |
↳ tags | array | Entity tags |
↳ key | string | Tag key |
↳ values | array | Tag values |
New Relic Create Deployment Event
Record a deployment change event in New Relic change tracking.
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | New Relic user API key for NerdGraph |
region | string | No | New Relic data center region: us or eu |
entityGuid | string | Yes | GUID of the entity associated with the deployment |
version | string | Yes | Deployment version, release name, or commit SHA |
shortDescription | string | No | Short description of the deployment |
description | string | No | Longer deployment description |
changelog | string | No | Deployment changelog text or URL |
commit | string | No | Commit SHA or identifier associated with the deployment |
deepLink | string | No | URL to the deployment, build, or release details |
user | string | No | User or automation that performed the deployment |
groupId | string | No | Optional group ID to correlate related changes |
customAttributes | json | No | Custom change event metadata as key-value pairs with string, number, or boolean values |
deploymentType | string | No | Deployment type: basic, blue green, canary, rolling, or shadow |
timestamp | number | No | Event timestamp in milliseconds since Unix epoch |