Tutorial NerdGraph: política de alertas

Para alertas New Relic, você pode gerenciar sua política de alertas usando nossa API NerdGraph.

Dica

Para saber como começar a usar o NerdGraph, consulte Introdução ao NerdGraph.

Listar e filtrar políticas

A consulta policiesSearch permite paginar todas as suas políticas de alertas por conta. Também permite algumas funcionalidades de filtragem nas políticas da conta.

Aqui está um exemplo:

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

Para paginar suas políticas, você deve solicitar o campo nextCursor na sua consulta inicial.

Com a paginação do cursor, você continua fazendo uma solicitação por meio do conjunto de resultados até que nextCursor retornado da resposta retorne vazio. Isso significa que você chegou ao fim dos seus resultados.

Aqui está um exemplo:

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

O código acima retorna um 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
          }
        }
      }
    }
  }
}

Portanto, em sua solicitação subsequente, forneça o cursor assim, até que ele fique vazio:

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

A API permite a consulta de políticas por meio de uma subseleção de ids. Isso retornará apenas as informações dessas políticas que você fornecer.

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

A API permite a consulta de políticas por nome. Use name para correspondência por nomes exatos ou nameLike para correspondência parcial. Ambos os critérios de pesquisa não diferenciam maiúsculas de minúsculas. Isso retornará apenas as informações das políticas que correspondem ao nome fornecido.

Neste exemplo, queremos encontrar políticas com DevOps no nome:

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

A API permite consultar por id de política:

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

Crie uma política

Para criar uma política, forneça um nome e um incidentPreference.

A preferência incidente configurará como os incidentes serão criados para cada condição criada na política. Para obter mais informações, consulte a documentação sobre como escolher sua preferência de incidente.

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

Atualizar uma política

Ao atualizar uma apólice, observe que você não precisa fornecer todos os atributos da apólice. Por exemplo, você só precisa fornecer o nome se pretende apenas atualizá-lo:

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

Excluir uma política

Você pode excluir políticas por meio da API NerdGraph. Observe que apenas o id pode ser solicitado de volta de um recurso excluído:

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

Esta tradução de máquina é fornecida para sua comodidade.

Tutorial NerdGraph: política de alertas

Dica

Listar e filtrar políticas

Listando todas as políticas de uma conta

Paginando por meio de políticas com paginação de cursor

Encontre todas as políticas por IDs selecionados

Encontre todas as políticas por nome

Encontrar política por ID

Crie uma política

Atualizar uma política

Excluir uma política

Esta tradução de máquina é fornecida para sua comodidade.

Tutorial NerdGraph: política de alertas

Dica

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

Paginando por meio de políticas com paginação de cursor

Encontre todas as políticas por IDs selecionados

Encontre todas as políticas por nome

Encontrar política por ID

Crie uma política

Atualizar uma política

Excluir uma política

Listar e filtrar políticas