Tutorial NerdGraph: assinatura de parceiro e revendedor

A funcionalidade de provisionamento de assinatura da nossa API NerdGraph permite que você, como parceiro da New Relic, crie assinaturas para suas contas. E dá acesso a uma gama mais ampla de produtos New Relic do que a Partner API.

Requisitos

Você não deve usar o NerdGraph para ajustar o provisionamento de sua assinatura, a menos que seja especificamente instruído por seu representante da New Relic.
Disponível apenas para contas de parceiros que seguem nosso modelo de preços original.

A funcionalidade de provisionamento do NerdGraph e a API de Parceria são compatíveis quando se trata dos produtos suportados por ambos (APM, Mobile, insights, browser, Sintético e infraestrutura). Se você usar o NerdGraph para criar uma assinatura para qualquer um dos produtos mais recentes, não será mais possível atualizar a conta usando a API de Parceria.

Primeiros passos: endpoint e chave de API

Para obter noções básicas do NerdGraph, consulte Introdução ao NerdGraph.

A funcionalidade de provisionamento do NerdGraph usa uma mutação chamada organizationProvisioningUpdatePartnerSubscription. Aqui está um exemplo de solicitação de alterações de assinatura em uma conta específica:

curl -v -d'{"query": "mutation { organizationProvisioningUpdatePartnerSubscription(accountId: PARTNER_ACCOUNT_ID, affectedAccountId: ACCOUNT_ID, 
products: [{id: 9200, name: \"Traces\", unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 40}]}]) {enqueued errors {message path } } }"}' -H'Content-type: application/json' -H'Api-key: YOUR_USER_KEY' https://api.newrelic.com/graphql

Assinatura do produto para uma conta

O NerdGraph não permite que você atualize ou faça downgrade da assinatura de produto individual de uma conta. Em vez disso, a API exige que você substitua (adicione) a configuração de todas as assinaturas de produtos da conta.

Dica

Se alguma configuração de produto não estiver incluída, o NerdGraph provisiona automaticamente a conta com um produto gratuito (quando disponível).

Mapeamento para produtos (productId)

A cada chamada de criação de conta, você deve fornecer pelo menos um tipo de produto New Relic. A consulta de mutação aceita apenas o productId numérico para o tipo.

O número de hosts permitidos por conta e o período de retenção de dados variam de acordo com o nível da assinatura dentro da estrutura de preços da APM. Por exemplo, o APM permite um número ilimitado de hosts permitidos para contas Lite, mas apenas um período de retenção de dados de 24 horas.

Além disso, a precificação e a retenção de dados dependem de você selecionar modelos de precificação baseados em hosts ou em unidade de computação (CU). Use o formato inteiro do ID do produto para identificar o nível de assinatura e o tipo de plano.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit`
Lite	18	Não aplicável
Padrão	41	`HOSTS`
Anual Padrão	38	`HOSTS`
Pró (anfitrião)	42	`HOSTS`
Pro Anual (Anfitrião)	39	`HOSTS`
Empreendimento	43	`HOSTS`
Anual Empresarial	40	`HOSTS`

Se você selecionar modelos de precificação baseados em unidade de computação (CU), use esses formatos inteiros de ID de produto para identificar o nível da assinatura e o tipo de plano.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit`
Pró CU	126	`COMPUTE_UNIT`
UC Pro Anual	127	`COMPUTE_UNIT`
APM Fundamentos UC	128	`COMPUTE_UNIT`
UC Anual do APM Essentials	129	`COMPUTE_UNIT`

Solicitações de exemplo

APM Pro com 5 hosts

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: :PARTNER_ACCOUNT_ID,
    affectedAccountId: :ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: HOSTS,
            quantity: 5
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

APM Pro CU com 3000 unidades de computação

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 126,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

A estrutura de preços do New Relic Mobile permite 100.000 usuários ativos mensais por conta no nível Enterprise da assinatura. A retenção de dados varia de acordo com o nível da assinatura. Use o formato inteiro do ID do produto para identificar o nível da assinatura.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
Lite	49	Não aplicável	Não aplicável
Empreendimento	54	`APPS`	`USERS`
Anual Empresarial	55	`APPS`	`USERS`

Solicitação de exemplo

Empresa mobile com 1 aplicativo e 100.000 usuários ativos mensais

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 54,
        unitsOfMeasure: [
          {
            unit: APPS,
            quantity: 1
          },
          {
            unit: USERS,
            quantity: 100000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Insights da New Relic baseiam a estrutura de preços no número de eventos permitidos armazenados e na política de retenção de dados associada. Por exemplo, a retenção de dados para insights é gratuita por um dia.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`	`unitsOfMeasure.unit.2`
Livre	67	Não aplicável	Não aplicável
Nenhum	65	Não aplicável	Não aplicável
Pró	66	`DATA_RETENTION_IN_DAYS`	`EVENTS_IN_MILLIONS`
Pró Anual	69	`DATA_RETENTION_IN_DAYS`	`EVENTS_IN_MILLIONS`

Solicitação de exemplo

Insights Pro com retenção de dados por 7 dias e 25 milhões de eventos

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 66,
        unitsOfMeasure: [
          {
            unit: DATA_RETENTION_IN_DAYS,
            quantity: 7
          },
          {
            unit: EVENTS_IN_MILLIONS,
            quantity: 25
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

A estrutura de preços do New Relic Browser permite um número ilimitado de usuários do aplicativo, independentemente do nível de assinatura. No entanto, o número de visualizações de página permitidas por mês e o período de retenção de dados variam de acordo com o nível da assinatura. Por exemplo:

As contas Lite incluem um número ilimitado de visualizações de página por mês e retenção de dados 24 horas por dia.

O preço da conta Pro começa em 500.000 visualizações de página por mês e três meses de retenção de dados.

Use o formato inteiro do ID do produto para identificar o nível da assinatura.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit`
Lite	76	Não aplicável
Pró	72	`PAGE_VIEWS`
Pró Anual	73	`PAGE_VIEWS`

Solicitação de exemplo

Browser Pro com 500.000 visualizações de página

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 42,
        unitsOfMeasure: [
          {
            unit: PAGE_VIEWS,
            quantity: 500000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Com a estrutura de preços da New Relic Synthetics, o número padrão de verificações de monitoramento permitidas e o período de retenção de dados variam de acordo com o nível da assinatura. Use o formato inteiro do ID do produto para identificar o nível da assinatura.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`
Lite	81	Não aplicável
Pró	77	`CHECKS`
Pró Anual	78	`CHECKS`

Solicitação de exemplo

Synthetics Pro com 10.000 verificações

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 77,
        unitsOfMeasure: [
          {
            unit: CHECKS,
            quantity: 10000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Com a estrutura de preços da New Relic Infrastructure, o número padrão de instância e o período de retenção de dados variam de acordo com o nível da assinatura. Os eventos de infraestrutura não contam para sua cota insights do New Relic, mesmo que você possa consultá-los em insights.

A New Relic Infrastructure oferece modelos de precificação baseados apenas em unidade de computação (CU). Use o formato inteiro do ID do produto para identificar o nível da assinatura.

Nível de assinatura	`products.id`	`unitsOfMeasure.unit`
Infraestrutura Nenhuma	142	Não aplicável
Infraestrutura Pro (CU)	134	`COMPUTE_UNIT`
Infraestrutura Pro Anual (CU)	135	`COMPUTE_UNIT`
Fundamentos de infraestrutura (CU)	136	`COMPUTE_UNIT`
Infraestrutura Essentials Anual (CU)	137	`COMPUTE_UNIT`

Solicitação de exemplo

Infraestrutura Pro com 5.000 unidades de computação

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 134,
        unitsOfMeasure: [
          {
            unit: COMPUTE_UNIT,
            quantity: 5000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`
Anual sem servidor	9010	`INGESTED_EVENTS`
Mensal sem servidor	9.000	`INGESTED_EVENTS`

Solicitação de exemplo

Mensal sem servidor com 3.000 eventos ingeridos em milhões

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9000,
        unitsOfMeasure: [
          {
            unit: INGESTED_EVENTS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`
Rastrear Anual	9200	`SPANS_IN_MILLIONS`
Rastrear Mensalmente	9210	`SPANS_IN_MILLIONS`

Solicitação de exemplo

Trace Anual com 3.000 períodos em milhões

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9200,
        unitsOfMeasure: [
          {
            unit: SPANS_IN_MILLIONS,
            quantity: 3000
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`
Logs Compromisso anual - 8 dias	9110	`GB_PER_DAY`
Logs Compromisso anual - 15 dias	9111	`GB_PER_DAY`
Logs Compromisso anual - 30 dias	9112	`GB_PER_DAY`
Logs Compromisso mensal - 8 dias	9100	`GB_PER_DAY`
Logs Compromisso mensal - 15 dias	9101	`GB_PER_DAY`
Logs Compromisso mensal - 30 dias	9102	`GB_PER_DAY`

Solicitação de exemplo

Log com retenção de dados de 8 dias e 100 Gigabytes por dia

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9100,
        unitsOfMeasure: [
          {
            unit: GB_PER_DAY,
            quantity: 100
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Nível de assinatura	`products.id`	`unitsOfMeasure.unit.1`
Compromisso Anual métrica	9310	`DPM`
Compromisso Mensal métrico	9300	`DPM`

Solicitação de exemplo

Compromisso Mensal métrica com 50 Pontos de Dados por Minuto

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9300,
        unitsOfMeasure: [
          {
            unit: DPM,
            quantity: 50
          }
        ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Tipos GraphQL

A funcionalidade de provisionamento do NerdGraph usa os seguintes tipos de GraphQL:

Nome	Tipo	Descrição
`account_id`	Inteiro	ID numérico da conta do parceiro da parceria à qual pertence a conta afetada.
`affected_account_id`	Inteiro	ID numérico da conta à qual serão aplicadas as alterações descritas no campo produtos.
`products`	Matriz de Produto	Coleção do tipo Produto representando os valores que irão compor a nova assinatura da Conta Afetada.

Nome	Tipo	Descrição
`Id`	Inteiro	ID numérico do Produto a ser adicionado à assinatura.
`Name`	Corda	Nome do Produto a ser adicionado à assinatura.
`Unit of Measure`	Matriz de Unidade de Medida	Coleção do tipo Unidade de Medida para este único produto.

Nome	Tipo	Descrição
`quantity`	Inteiro	Valor numérico da quantidade de unidades a serem aplicadas na assinatura.
`unit`	Corda	Nome da unidade a ser aplicada ao produto (varia conforme a linha de produto).

Exemplos

Aqui estão exemplos de uma chamada de API para criar uma assinatura e a resposta JSON.

mutation {
  organizationProvisioningUpdatePartnerSubscription (
    accountId: PARTNER_ACCOUNT_ID,
    affectedAccountId: ACCOUNT_ID,
    products: [
      {
        id: 9410,
        unitsOfMeasure: [{unit: INCIDENT_EVENTS, quantity: 50}]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: HOSTS, quantity: 5 }]
      },
      {
        id: 42,
        unitsOfMeasure: [{unit: PAGE_VIEWS, quantity: 500000}]
      },
      {
        id: 134,
        unitsOfMeasure: [{unit: COMPUTE_UNIT, quantity: 5000}]
      },
      {
        id: 66,
        unitsOfMeasure: [
          {unit: DATA_RETENTION_IN_DAYS, quantity: 7 },
          {unit: EVENTS_IN_MILLIONS, quantity: 25 }
        ]
      },
      {
        id: 9100,
        unitsOfMeasure: [{unit: GB_PER_DAY, quantity: 100 } ]
      },
      {
        id: 9300,
        unitsOfMeasure: [{unit: DPM, quantity: 50 }
        ]
      },
      {
        id: 54,
        unitsOfMeasure: [
          {unit: APPS, quantity: 1 },
          {unit: USERS, quantity: 100000 }
        ]
      },
      {
        id: 9000,
        unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]
      },
      {
        id: 77,
        unitsOfMeasure: [{unit: CHECKS, quantity: 10000 } ]
      },
      {
        id: 9200,
        unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 3000 } ]
      }
    ]
  ) {
    enqueued
    errors {
      message
      path
    }
  }
}

Esta consulta retorna o seguinte:

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

mutation {
    organizationProvisioningUpdatePartnerSubscription (
      accountId: :PARTNER_ACCOUNT_ID,
      affectedAccountId: :ACCOUNT_ID,
      products: [
        {
          id: 9110,
          unitsOfMeasure: [
            {
              unit: GB_PER_DAY,
              quantity: 100
            },
            {
              unit: DATA_RETENTION_IN_DAYS,
              quantity: 8
            }

          ]
        }
      ]
    ) {
      enqueued
      errors {
        message
        path
      }
  }
}

Esta consulta retorna o seguinte:

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

Response: Assim que o NerdGraph receber sua solicitação e validar que ela está no formato correto, ele responderá com uma mensagem como esta. Isso não significa que sua mensagem foi processada ou aplicada com êxito; mas foi validado para estar no formato correto e colocado na fila para processamento.

{
  "data": {
    "organizationProvisioningUpdatePartnerSubscription": {
      "enqueued": true,
      "errors": []
    }
  }
}

Variações da API de Parceria

Estas são algumas diferenças importantes entre a funcionalidade de provisionamento do NerdGraph e a API do Parceiro que o usuário frequente da API do Parceiro deve conhecer:

Recurso	Descrição
Chave de API	NerdGraph usa um . A Partner API usa a chave de API Partnership.
`productId` e `product_id`	Os IDs de produto do NerdGraph são diferentes daqueles usados para a API de Parceria.
`Curl` formato de solicitação	Para fazer uma solicitação `curl` ao NerdGraph, o formato será diferente da API Partnership: O endpoint do URL é diferente A chave de API necessária é sua chave de API pessoal NerdGraph responde apenas a solicitações HTTP POST
Unidades `INGESTED_EVENTS` sem servidor estão em milhões	o envio de `unitsOfMeasure: [{unit: INGESTED_EVENTS, quantity: 3000 } ]` será interpretado pelo NerdGraph como 3.000 milhões de eventos.
Insights e dispositivos móveis exigem duas unidades de medida	Insights requer `DATA_RETENTION_IN_DAYS` e `EVENTS_IN_MILLIONS` Dispositivos móveis requerem `APPS` e `USERS`.
A unidade de medida de retenção de dados de log é determinada pelo productID	Isso está especificado no nome do produto: Logs Compromisso anual - 8 dias \| ID do produto: 9110 Logs Compromisso anual - 15 dias \| ID do produto: 9111 Logs Compromisso anual - 30 dias \| ID do produto: 9112 Logs Compromisso mensal - 8 dias \| ID do produto: 9100 Logs Compromisso mensal - 15 dias \| ID do produto: 9101 Logs Compromisso mensal - 30 dias \| ID do produto: 9102

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

Tutorial NerdGraph: assinatura de parceiro e revendedor

Requisitos

Primeiros passos: endpoint e chave de API

Assinatura do produto para uma conta

Dica

Mapeamento para produtos (productId)

APM

Solicitações de exemplo

Mobile

Solicitação de exemplo

Insights

Solicitação de exemplo

Browser

Solicitação de exemplo

Sintético

Solicitação de exemplo

A infraestrutura

Solicitação de exemplo

Sem servidor para Lambda

Solicitação de exemplo

Traces

Solicitação de exemplo

Registro

Solicitação de exemplo

Métrica

Solicitação de exemplo

Tipos GraphQL

Assinatura

Produtos

Unidade de medida

Exemplos

Crie (substitua a existente) assinatura com muitos produtos

Criar (substituir a existente) assinatura por um produto - log

Variações da API de Parceria

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

Tutorial NerdGraph: assinatura de parceiro e revendedor

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

Primeiros passos: endpoint e chave de API

Assinatura do produto para uma conta

Dica

Mapeamento para produtos (productId)

Mobile

Insights

Browser

Sintético

A infraestrutura

Sem servidor para Lambda

Traces

Registro

Métrica

Tipos GraphQL

Assinatura

Produtos

Unidade de medida

Exemplos

Crie (substitua a existente) assinatura com muitos produtos

Criar (substituir a existente) assinatura por um produto - log

Variações da API de Parceria

Requisitos