New Relic é uma plataforma de observabilidade para monitorar desempenho de aplicações, infraestrutura, logs, traces e mudanças com impacto no negócio em seus sistemas. Ela centraliza a telemetria no NRDB e expõe esses dados pelo NerdGraph, a API GraphQL do New Relic.
Com o New Relic, você pode:
- Consultar telemetria com NRQL: Executar NRQL contra os dados da conta para inspecionar saúde do serviço, uso, erros, latência e eventos personalizados.
- Encontrar entidades monitoradas: Pesquisar serviços, aplicações, hosts e outros recursos monitorados por nome, tipo, tags, estado de alerta ou status de reporting.
- Obter detalhes da entidade: Resolver um GUID de entidade em metadados básicos para etapas posteriores do fluxo de trabalho.
- Registrar mudanças de deployment: Criar eventos de rastreamento de mudanças de deployment com versão, changelog, commit, links de build, group IDs e contexto do usuário.
A integração New Relic do Zoen permite que agentes tragam sinais de observabilidade de produção para os fluxos de trabalho e anotem releases ou mudanças operacionais diretamente pela automação. Use-a para resumir a saúde ao vivo do serviço, rotear fluxos de incidentes a partir de buscas de entidades ou marcar deployments para que os charts do New Relic correlacionem mudanças de desempenho com a atividade de release.
Usage Instructions
Integrate New Relic into workflows. 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
| 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 |
accountId | number | Yes | New Relic account ID to query |
nrql | string | Yes | NRQL query to execute |
timeout | number | No | Optional query timeout in seconds |
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.
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 |
Output
| Parameter | Type | Description |
|---|---|---|
event | object | Created New Relic change tracking event |
↳ changeTrackingId | string | New Relic change tracking ID |
↳ customAttributes | json | Custom attributes on the change tracking event |
↳ category | string | Change category |
↳ categoryAndType | string | Combined category and type |
↳ type | string | Change type |
↳ shortDescription | string | Short change description |
↳ description | string | Change description |
↳ timestamp | number | Change timestamp in milliseconds |
↳ user | string | User associated with the change |
↳ groupId | string | Change group ID |
↳ entity | object | Entity associated with the change |
↳ guid | string | Entity GUID |
↳ name | string | Entity name |
messages | array | Messages returned by New Relic for the created change event |