Tutorial do NerdGraph: Gerenciando o Fleet Control

Disponibilidade de recurso

Fleet Control for Kubernetes clusters está disponível de forma geral (GA). O suporte para gerenciamento de agentes em Linux and Windows hosts está atualmente em versão prévia pública.

Para obter uma lista completa de agentes suportados e seus ambientes, consulte nossa documentação de compatibilidade de tipos de agentes.

O recurso de visualização pública é fornecido de acordo com nossas políticas de pré-lançamento.

Você pode usar o NerdGraph para gerenciar programaticamente frotas, membros e implantações do Fleet Control. Essas mutações fornecem controle total sobre as operações da frota, permitindo automatizar o gerenciamento da frota, integrar com pipelines de CI/CD e gerenciar a instrumentação em escala.

Este tutorial fornece exemplos das mutações e consultas disponíveis do Fleet Control. Você pode usá-los para criar frotas, gerenciar membros da frota e implantar configurações de agente.

Pré-requisitos

Uma conta New Relic com acesso à sua chave de usuário da API
A função Organization Manager ou uma função personalizada com permissões de gerenciamento de frota
Familiaridade com GraphQL e NerdGraph

Dica

Você também pode usar o Fleet Control CLI para gerenciamento de frota via linha de comando. A CLI é construída na mesma API NerdGraph.

Importante

As configurações do agente são gerenciadas através do Blob Storage API, não pelo NerdGraph. Todas as operações de configuração usam uma API REST separada.

Mutações de gerenciamento de frota

Use a mutação fleetControlCreateFleet para criar uma nova frota para gerenciar grupos de Kubernetes clusters ou hosts.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`fleetEntity`	Objeto	Sim	A entrada de criação da entidade de frota contendo a configuração da frota.
`fleetEntity.name`	Corda	Sim	O nome da frota. Deve ser único na sua organização.
`fleetEntity.managedEntityType`	Enum	Sim	O tipo de entidades que esta frota gerenciará. Opções: `HOST` (para hosts Linux/Windows) ou `KUBERNETESCLUSTER` .
`fleetEntity.scope`	Objeto	Sim	O escopo da entidade que define se a frota tem escopo de conta ou de organização.
`fleetEntity.scope.type`	Enum	Sim	Tipo de escopo. Opções: `ACCOUNT` ou `ORGANIZATION` .
`fleetEntity.scope.id`	EU IA	Sim	O ID da conta ou ID da organização, dependendo do tipo de escopo.
`fleetEntity.description`	Corda	Não	Uma descrição do propósito da frota.
`fleetEntity.operatingSystem`	Objeto	Não	Tipo de sistema operacional para frotas de HOST. Obrigatório se `managedEntityType` for `HOST` .
`fleetEntity.operatingSystem.type`	Enum	Sim (se operatingSystem for fornecido)	Tipo de SO. Opções: `LINUX` ou `WINDOWS` .
`fleetEntity.tags`	Matriz	Não	Lista de objetos de tag para categorizar a frota.

Solicitação de amostra

mutation CreateFleet {
  fleetControlCreateFleet(
    fleetEntity: {
      name: "Production Web Servers"
      description: "Fleet for all production Linux web server hosts"
      managedEntityType: HOST
      operatingSystem: { type: LINUX }
      scope: { type: ACCOUNT, id: "YOUR_ACCOUNT_ID" }
      tags: [
        { key: "environment", values: ["production"] }
        { key: "team", values: ["platform"] }
      ]
    }
  ) {
    entity {
      id
      name
      description
      managedEntityType
    }
  }
}

Resposta de amostra

{
  "data": {
    "fleetControlCreateFleet": {
      "entity": {
        "id": "<YOUR_FLEET_ID>",
        "name": "Production Web Servers",
        "description": "Fleet for all production Linux web server hosts",
        "managedEntityType": "HOST"
      }
    }
  }
}

Use a mutação fleetControlUpdateFleet para atualizar o nome, a descrição ou as tags de uma frota existente.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	EU IA	Sim	O ID da entidade da frota a ser atualizado.
`fleetUpdate`	Objeto	Sim	A entrada de atualização da frota contendo campos para modificar.
`fleetUpdate.name`	Corda	Não	Nome da frota atualizado.
`fleetUpdate.description`	Corda	Não	Descrição da frota atualizada.
`fleetUpdate.tags`	Matriz	Não	Lista atualizada de tags.

Solicitação de amostra

mutation UpdateFleet {
  fleetControlUpdateFleet(
    id: "<YOUR_FLEET_ID>"
    fleetUpdate: {
      description: "Updated: Production web servers with enhanced monitoring"
      tags: [
        { key: "environment", values: ["production"] }
        { key: "region", values: ["us-east-1", "us-west-2"] }
      ]
    }
  ) {
    entity {
      id
      name
      description
    }
  }
}

Use a mutação fleetControlDeleteFleet para excluir uma frota. Isso remove a frota, mas não desinstala agentes de entidades gerenciadas.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	EU IA	Sim	O ID da entidade da frota a ser excluído.

Solicitação de amostra

mutation DeleteFleet {
  fleetControlDeleteFleet(id: "<YOUR_FLEET_ID>") {
    id
  }
}

Mutações de gerenciamento de membros da frota

Use a mutação fleetControlAddFleetMembers para adicionar entidades gerenciadas aos anéis de frota. Os anéis permitem organizar entidades dentro de uma frota para rollouts em fases (por exemplo, canary, staging, produção).

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`fleetId`	EU IA	Sim	O ID da entidade da frota.
`members`	Matriz	Sim	Lista de entradas de anel especificando quais entidades adicionar a quais anéis.
`members[].ring`	Corda	Sim	O nome do anel (por exemplo, "canary", "produção").
`members[].entityIds`	Matriz	Sim	Lista de GUIDs de entidade para adicionar ao anel.

Solicitação de amostra

mutation AddFleetMembers {
  fleetControlAddFleetMembers(
    fleetId: "<YOUR_FLEET_ID>"
    members: [
      {
        ring: "canary"
        entityIds: ["<YOUR_ENTITY_ID_1>", "<YOUR_ENTITY_ID_2>"]
      }
      { ring: "production", entityIds: ["<YOUR_ENTITY_ID_3>"] }
    ]
  ) {
    items {
      id
      name
      ring
    }
  }
}

Use a mutação fleetControlRemoveFleetMembers para remover entidades gerenciadas dos anéis de frota.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`fleetId`	EU IA	Sim	O ID da entidade da frota.
`members`	Matriz	Sim	Lista de entradas de anel especificando quais entidades remover de quais anéis.
`members[].ring`	Corda	Sim	O nome do anel.
`members[].entityIds`	Matriz	Sim	Lista de GUIDs de entidade para remover do anel.

Solicitação de amostra

mutation RemoveFleetMembers {
  fleetControlRemoveFleetMembers(
    fleetId: "<YOUR_FLEET_ID>"
    members: [{ ring: "canary", entityIds: ["<YOUR_ENTITY_ID>"] }]
  ) {
    items {
      id
      ring
    }
  }
}

Mutações de gerenciamento de implantação

Use a mutação fleetControlCreateFleetDeployment para criar uma implantação que define quais versões do agente e configurações implantar em uma frota.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`fleetDeployment`	Objeto	Sim	A configuração de implantação.
`fleetDeployment.fleetId`	EU IA	Sim	O ID da entidade da frota.
`fleetDeployment.scope`	Objeto	Sim	O escopo da entidade (o mesmo que o escopo da frota).
`fleetDeployment.agents`	Matriz	Sim	Lista de configurações do agente para implantar.
`fleetDeployment.agents[].agentType`	Corda	Sim	Tipo de agente. Opções: `NRInfra` , `NRDOT` , `FluentBit` , `NRPrometheusAgent` , `PipelineControlGateway` , `NRApmOperator` , `NReBPFAgent` .
`fleetDeployment.agents[].version`	Corda	Sim	Versão do agente a ser implantada.
`fleetDeployment.agents[].configurationVersionList`	Matriz	Sim	Lista de IDs de versão de configuração para este agente.
`fleetDeployment.name`	Corda	Não	Nome do deployment.
`fleetDeployment.description`	Corda	Não	Descrição da implantação.

Solicitação de amostra

mutation CreateDeployment {
  fleetControlCreateFleetDeployment(
    fleetDeployment: {
      fleetId: "<YOUR_FLEET_ID>"
      name: "Infrastructure Agent v1.50.0"
      description: "Deploy infra agent 1.50.0 with updated config"
      scope: { type: ACCOUNT, id: "YOUR_ACCOUNT_ID" }
      agents: [
        {
          agentType: "NRInfra"
          version: "1.50.0"
          configurationVersionList: [{ id: "<YOUR_CONFIGURATION_ID>" }]
        }
      ]
    }
  ) {
    entity {
      id
      name
      description
    }
  }
}

Use a mutação fleetControlUpdateFleetDeployment para atualizar a configuração de um deployment existente.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	EU IA	Sim	O ID do deployment a ser atualizado.
`fleetDeploymentUpdate`	Objeto	Sim	A entrada de atualização de implantação.
`fleetDeploymentUpdate.name`	Corda	Não	Nome do deployment atualizado.
`fleetDeploymentUpdate.description`	Corda	Não	Descrição atualizada.
`fleetDeploymentUpdate.agents`	Matriz	Não	Configurações do agente atualizadas.

Solicitação de amostra

mutation UpdateDeployment {
  fleetControlUpdateFleetDeployment(
    id: "<YOUR_DEPLOYMENT_ID>"
    fleetDeploymentUpdate: {
      description: "Updated to infra agent 1.50.1"
      agents: [
        {
          agentType: "NRInfra"
          version: "1.50.1"
          configurationVersionList: [{ id: "<YOUR_CONFIGURATION_ID>" }]
        }
      ]
    }
  ) {
    entity {
      id
      name
    }
  }
}

Use a mutação fleetControlDeploy para acionar uma implantação a ser distribuída para anéis de frota específicos.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	EU IA	Sim	O ID do deployment a ser acionado.
`policy`	Objeto	Sim	Política de implantação especificando em quais anéis implantar.
`policy.ringDeploymentPolicy`	Objeto	Sim	Política de implantação em anel.
`policy.ringDeploymentPolicy.ringsToDeploy`	Matriz	Sim	Lista de nomes de anéis para implantação.

Solicitação de amostra

mutation TriggerDeployment {
  fleetControlDeploy(
    id: "<YOUR_DEPLOYMENT_ID>"
    policy: { ringDeploymentPolicy: { ringsToDeploy: ["canary"] } }
  ) {
    fleetId
  }
}

Use a mutação fleetControlDeleteFleetDeployment para excluir um deployment.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	EU IA	Sim	O ID da implantação a ser excluído.

Solicitação de amostra

mutation DeleteDeployment {
  fleetControlDeleteFleetDeployment(id: "<YOUR_DEPLOYMENT_ID>") {
    id
  }
}

Recursos adicionais

Referência deBlob Storage API - Para gerenciar configurações do agente
Fleet Control visão geral
Fleet Control CLI
Introdução a NerdGraph
NerdGraph Explorer

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

Tutorial do NerdGraph: Gerenciando o Fleet Control

Disponibilidade de recurso

Pré-requisitos

Dica

Importante

Mutações de gerenciamento de frota

Criar uma frota

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Atualizar uma frota

Parâmetro de entrada

Solicitação de amostra

Excluir uma frota

Parâmetro de entrada

Solicitação de amostra

Mutações de gerenciamento de membros da frota

Adicionar membros a uma frota

Parâmetro de entrada

Solicitação de amostra

Remover membros de uma frota

Parâmetro de entrada

Solicitação de amostra

Mutações de gerenciamento de implantação

Criar uma implantação

Parâmetro de entrada

Solicitação de amostra

Atualizar um deployment

Parâmetro de entrada

Solicitação de amostra

Disparar uma implantação

Parâmetro de entrada

Solicitação de amostra

Excluir uma implantação

Parâmetro de entrada

Solicitação de amostra

Recursos adicionais

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

Tutorial do NerdGraph: Gerenciando o Fleet Control

Disponibilidade de recurso

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Dica

Importante

Mutações de gerenciamento de frota

Atualizar uma frota

Excluir uma frota

Mutações de gerenciamento de membros da frota

Adicionar membros a uma frota

Remover membros de uma frota

Mutações de gerenciamento de implantação

Criar uma implantação

Atualizar um deployment

Disparar uma implantação

Excluir uma implantação

Recursos adicionais

Pré-requisitos