Tutorial de NerdGraph: Políticas de alertas

Para las alertas de New Relic, puede administrar su política de alertas utilizando nuestra API NerdGraph.

Sugerencia

Para saber cómo empezar a utilizar NerdGraph, consulte Introducción a NerdGraph.

Listar y filtrar políticas

La consulta policiesSearch le permite paginar todas sus políticas de alertas por cuenta. También permite algunas funciones de filtrado en las políticas de la cuenta.

He aquí un ejemplo:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

Para paginar sus políticas, debe solicitar el campo nextCursor en su consulta inicial.

Con la paginación del cursor, continúa realizando una solicitud a través del conjunto de resultados hasta que el nextCursor que se devuelve de la respuesta vuelve vacío. Esto significa que llegó al final de sus resultados.

He aquí un ejemplo:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

El código anterior devuelve un conjunto de resultados como este:

{
  "data": {
    "actor": {
      "account": {
        "alerts": {
          "policiesSearch": {
            "nextCursor": "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=",
            "policies": [
              {
                "id": "3455",
                "incidentPreference": "PER_POLICY",
                "name": "First Policy Name"
              },
              {
                "id": "2123",
                "incidentPreference": "PER_POLICY",
                "name": "Another Policy"
              }
              // ... more policies here in reality
            ],
            "totalCount": 745
          }
        }
      }
    }
  }
}

Entonces, en su solicitud posterior, proporcione el cursor así, hasta que el cursor esté vacío:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(
          cursor: "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM="
        ) {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

La API permite la consulta de políticas mediante una subselección de identificadores. Esto solo devolverá la información de estas políticas que usted proporcione.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(
          searchCriteria: { ids: [A_POLICY_ID, ANOTHER_POLICY_ID] }
        ) {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

La API permite consultar políticas por nombre. Utilice name para hacer coincidencias por nombres exactos o nameLike para una coincidencia parcial. Ambos criterios de búsqueda no distinguen entre mayúsculas y minúsculas. Esto solo devolverá la información de las políticas que coincidan con el nombre proporcionado.

En este ejemplo, queremos buscar políticas con DevOps en el nombre:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(searchCriteria: { nameLike: "DevOps" }) {
          policies {
            id
            name
          }
        }
      }
    }
  }
}

La API le permite consultar por ID de política:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policy(id: YOUR_POLICY_ID) {
          id
          name
          incidentPreference
        }
      }
    }
  }
}

Crear una política

Para crear una política, proporcione un nombre y un incidentPreference.

La preferencia de incidentes configurará cómo se crean los incidentes para cada condición creada en la política. Para obtener más información, consulta la documentación sobre cómo elegir la preferencia de eventos de alerta.

mutation {
  alertsPolicyCreate(
    accountId: YOUR_ACCOUNT_ID
    policy: { name: "Your Policy Name", incidentPreference: PER_CONDITION }
  ) {
    id
    name
    incidentPreference
  }
}

Actualizar una política

Cuando actualiza una política, tenga en cuenta que no es necesario proporcionar todos los atributos de la política. Por ejemplo, solo necesita proporcionar el nombre si solo desea actualizarlo:

mutation {
  alertsPolicyUpdate(
    accountId: YOUR_ACCOUNT_ID
    id: YOUR_POLICY_ID
    policy: { name: "Updated Policy Name" }
  ) {
    id
    name
    incidentPreference
  }
}

Eliminar una política

Puede eliminar políticas a través de la API NerdGraph. Tenga en cuenta que solo se puede solicitar la identificación de un recurso eliminado:

mutation {
  alertsPolicyDelete(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID) {
    id
  }
}

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

Tutorial de NerdGraph: Políticas de alertas

Sugerencia

Listar y filtrar políticas

Listado de todas las políticas de una cuenta

Paginar a través de políticas con paginación del cursor

Buscar todas las políticas por identificadores seleccionados

Buscar todas las pólizas por nombre

Buscar póliza por ID

Crear una política

Actualizar una política

Eliminar una política

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

Tutorial de NerdGraph: Políticas de alertas

Sugerencia

Listar y filtrar políticas .css-21sua1{background:none;border:none;width:0;padding:0;}

Paginar a través de políticas con paginación del cursor

Buscar todas las políticas por identificadores seleccionados

Buscar todas las pólizas por nombre

Buscar póliza por ID

Crear una política

Actualizar una política

Eliminar una política

Listar y filtrar políticas