Tutorial de NerdGraph: Administración de las reglas de normalización de métricas

avance

¡Aún estamos trabajando en esta característica, pero nos encantaría que la probaras! Esta característica se proporciona actualmente como parte de un programa de vista previa de acuerdo con nuestras políticas de prelanzamiento.

Puede usar mutaciones de NerdGraph para administrar reglas de normalización de métricas en New Relic. Al aprovechar estas mutaciones, puede crear, editar, activar y desactivar estas reglas directamente desde la cuenta de New Relic. Esto proporciona un enfoque simplificado y programático para resolver los problemas de agrupación de métricas (MGI).

Las reglas de normalización de métricas se utilizan para:

Agrupe o filtre los datos de intervalo de tiempo de métrica.
Administre las métricas de alta cardinalidad al cambiar su nombre, eliminarlas o transformarlas antes de que se ingieran en New Relic.
Prevenir los MGI para garantizar que las métricas estén bien organizadas y sean significativas.
Reducir el número de nombres de métricas únicos reportados a New Relic.

Requisitos previos

Una cuenta de New Relic, y con esa cuenta, puede acceder a la clave de usuario de la API que necesita incluir en las consultas y mutaciones.
El tipo de usuario y los roles asignados pueden afectar sus permisos de NerdGraph. Para obtener más detalles, consulte Factores que afectan el acceso.

Sugerencia

También puede crear una regla de normalización de métricas usando la plataforma de New Relic. Para obtener más información, consulte Reglas de normalización de métricas.

Recuperar las reglas de normalización de métricas

Utilice la consulta metricNormalizationRules para obtener todas las reglas de normalización de métricas asociadas a la cuenta. Esta consulta proporciona una visión general completa de las reglas existentes, incluyendo su estado y configuración.

parámetro de entrada

Nombre del atributo	Tipo de datos	Descripción
`accountId`	Cadena	(Obligatorio) El ID de la cuenta asociado a la regla.
`enable`	Booleano	(Obligatorio) Si se establece en `true`, solo se devuelven las reglas habilitadas.

Consulta de muestra

{
  actor {
    user {
      name
    }
    account(id: xxxxxx) {
      metricNormalization {
        metricNormalizationRules(enabled: true) {
          action
          applicationGuid
          applicationName
          createdAt
          enabled
          evalOrder
          id
          matchExpression
          notes
          replacement
          terminateChain
        }
      }
    }
  }
}

Mutaciones

Administre las reglas de normalización de métricas con las siguientes mutaciones de NerdGraph:

Use la mutación metricNormalizationCreateRule para crear una nueva regla de normalización de métricas en New Relic.

parámetro de entrada

Nombre del atributo	Tipo de datos	Descripción
ID de la cuenta	Cadena	(Obligatorio) El ID de la cuenta asociado a la regla.
acción	Cadena	(Obligatorio) Seleccione una de las siguientes acciones: `REPLACE`: Reemplace las métricas que coinciden con el `matchExpression` con el valor definido en el campo `replacement`. `IGNORE`: bloquee el reporte a New Relic de cualquier métrica que coincida con `matchExpression`. `DENY_NEW_METRICS`: evite la creación de nuevos nombres de métricas que coincidan con `matchExpression`, mientras permite que los nombres de métricas existentes sigan reportando.
applicationGuid	Cadena	(Opcional) El GUID único para la aplicación en New Relic. Si se deja en blanco, se convierte en una regla para toda la cuenta.
activado	Booleano	(Obligatorio) Para habilitar la regla, defínala como `true`.
evalOrder	Entero	(Obligatorio) Especifique el orden en el que se aplica la regla en relación con otras reglas. Cuanto menor sea el número, mayor será la prioridad evaluada. El valor recomendado es `2000`.
matchExpression	Cadena	(Obligatorio) Acepta un patrón de expresión regular que coincida con las métricas a normalizar. Este campo debe comenzar con un `^` y terminar con un `$`. Define un patrón para identificar qué métricas deben ser afectadas por la regla de normalización. Por ejemplo: `^WebTransaction/Uri/RESTfulExample/users/username/[a-zA-Z0-9]+$` El patrón `^[a-zA-Z0-9]+$` coincide con cualquier cadena compuesta por caracteres en minúscula `(a-z)`, caracteres en mayúscula `(A-Z)` y números `(0-9)`.
notas	Cadena	Notas adicionales o comentarios sobre la regla de normalización.
reemplazo	Cadena	Este campo solo es obligatorio cuando se selecciona la opción `REPLACE` de la lista desplegable `action`. Reemplaza cualquier nombre de métrica que coincida con `matchExpression`. Por ejemplo: `WebTransaction/Uri/RESTfulExample/users/username/{username}$`
terminateChain	Booleano	(Obligatorio) Si se establece en `true`, no se aplicarán más reglas a las métricas coincidentes.

Consulta de muestra

mutation {
  metricNormalizationCreateRule(
    accountId: xxxxxx
    rule: {
      action: REPLACE
      applicationGuid: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      enabled: false
      evalOrder: 2000
      matchExpression: "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$"
      notes: "rules to replace"
      replacement: "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}"
      terminateChain: true
    }
  ) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

Ejemplo de respuesta

{
        "data": {
            "metricNormalizationCreateRule": {
                "errors": [],
                "rule": {
                    "action": "REPLACE",
                    "applicationGuid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                    "applicationName": "MetricGroupingIssue",
                    "createdAt": 1743641443000,
                    "enabled": false,
                    "evalOrder": 2000,
                    "id": 29205,
                    "matchExpression": "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$",
                    "notes": "rules to replace",
                    "replacement": "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}",
                    "terminateChain": true
                }
            }
        }
    }

Utilice la mutación metricNormalizationEditRule para actualizar el valor de la regla existente usando los parámetros ruleId. Proporciona flexibilidad para ajustar la regla según la nueva información valiosa o los requisitos cambiantes. Puede obtener información de ruleId mediante la consulta Retrieve the metric normalization rules.

parámetro de entrada

Nombre del atributo	Tipo de datos	Descripción
ID de la cuenta	Cadena	(Obligatorio) El ID de la cuenta asociado a la regla.
acción	Cadena	(Obligatorio) Seleccione una de las siguientes acciones: `REPLACE`: Reemplace las métricas que coinciden con el `matchExpression` con el valor definido en el campo `replacement`. `IGNORE`: bloquee el reporte a New Relic de cualquier métrica que coincida con `matchExpression`. `DENY_NEW_METRICS`: evite la creación de nuevos nombres de métricas que coincidan con `matchExpression`, mientras permite que los nombres de métricas existentes sigan reportando.
applicationGuid	Cadena	(Opcional) El GUID único para la aplicación en New Relic. Si se deja en blanco, se convierte en una regla para toda la cuenta.
activado	Booleano	(Obligatorio) Para habilitar la regla, defínala como `true`.
evalOrder	Entero	(Obligatorio) Especifique el orden en el que se aplica la regla en relación con otras reglas. Cuanto menor sea el número, mayor será la prioridad evaluada. El valor recomendado es `2000`.
identificación	Cadena	(Obligatorio) El `ruleId` de la regla de métrica cuyo valor desea actualizar.
matchExpression	Cadena	(Obligatorio) Acepta un patrón de expresión regular que coincida con las métricas a normalizar. Este campo debe comenzar con un `^` y terminar con un `$`. Define un patrón para identificar qué métricas deben ser afectadas por la regla de normalización. Por ejemplo: `^WebTransaction/Uri/RESTfulExample/users/username/[a-zA-Z0-9]+$` El patrón `^[a-zA-Z0-9]+$` coincide con cualquier cadena compuesta por caracteres en minúscula `(a-z)`, caracteres en mayúscula `(A-Z)` y números `(0-9)`.
notas	Cadena	Notas adicionales o comentarios sobre la regla de normalización.
reemplazo	Cadena	Este campo solo es obligatorio cuando se selecciona la opción `REPLACE` de la lista desplegable `action`. Reemplaza cualquier nombre de métrica que coincida con `matchExpression`. Por ejemplo: `WebTransaction/Uri/RESTfulExample/users/username/{username}$`
terminateChain	Booleano	(Obligatorio) Si se establece en `true`, no se aplicarán más reglas a las métricas coincidentes.

Consulta de muestra

mutation {
  metricNormalizationEditRule(
    accountId: xxxxx
    rule: {
      id: 29205
      notes: "rules to replace"
      matchExpression: "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$"
      action: REPLACE
      enabled: false
      replacement: "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}"
    }
  ) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

Utilice la mutación metricNormalizationEnableRule para habilitar una regla previamente deshabilitada mediante los parámetros accountId y ruleId. Puede obtener estos parámetros mediante la consulta Retrieve the metric normalization rules.

Parámetros de entrada

Nombre del atributo	Tipo de datos	Descripción
ID de la cuenta	Cadena	(Obligatorio) El ID de la cuenta asociado a la regla.
ruleId	Cadena	(Obligatorio) El `ruleId` de la regla de métrica.

Consulta de ejemplo

mutation {
  metricNormalizationEnableRule(accountId: xxxxxx, ruleId: 29205) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

Utilice la mutación metricNormalizationDisableRule para desactivar una regla previamente habilitada mediante los parámetros accountId y ruleId. Puede obtener estos parámetros mediante la consulta Retrieve the metric normalization rules.

Parámetros de entrada

Nombre del atributo	Tipo de datos	Descripción
ID de la cuenta	Cadena	(Obligatorio) El ID de la cuenta asociado a la regla.
ruleId	Cadena	(Obligatorio) El `ruleId` de la regla de métrica.

Consulta de ejemplo

mutation {
  metricNormalizationDisableRule(accountId: xxxxxx, ruleId: 29205) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

Te ofrecemos esta traducción automática para facilitar la lectura.

Tutorial de NerdGraph: Administración de las reglas de normalización de métricas

avance

Requisitos previos

Sugerencia

Recuperar las reglas de normalización de métricas

parámetro de entrada

Consulta de muestra

Mutaciones

Crear una regla de normalización de métricas

parámetro de entrada

Consulta de muestra

Ejemplo de respuesta

Editar una regla de normalización de métricas

parámetro de entrada

Consulta de muestra

Activar una regla de normalización de métricas

Parámetros de entrada

Consulta de ejemplo

Desactivar una regla de normalización de métricas

Parámetros de entrada

Consulta de ejemplo

Te ofrecemos esta traducción automática para facilitar la lectura.

Tutorial de NerdGraph: Administración de las reglas de normalización de métricas

avance

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Sugerencia

Recuperar las reglas de normalización de métricas

parámetro de entrada

Consulta de muestra

Mutaciones

Editar una regla de normalización de métricas

Activar una regla de normalización de métricas

Desactivar una regla de normalización de métricas

Requisitos previos