Como gerenciar coletores de dados

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Um recurso de coletor de dados permite coletar uma grande variedade de dados personalizados do tráfego da API. Depois de criar um coletor de dados, especifique os dados que você quer coletar usando a política DataCapture. O coletor de dados é como um carrinho de compras, e a política DataCapture é uma lista de compras dos dados que você quer capturar.

Observação: Se você usar um coletor de dados em várias políticas, os dados capturados serão substituídos pela última política executada.

Para visualizar uma lista das quantidades relacionadas ao tráfego da API que podem ser capturadas usando o recurso Coletor de dados, consulte Métricas.

Como criar um coletor de dados

É possível criar um recurso Coletor de dados na IU da Apigee ou com a API Apigee:

Observação: há uma nova versão da IU da Apigee, que está integrada ao console do Google Cloud. A nova interface é chamada de Apigee no console do Cloud. As instruções nas duas primeiras guias abaixo explicam como usar a Apigee no console do Cloud ou a Apigee clássica.

Apigee no console do Cloud

Para criar um recurso de coletor de dados usando a Apigee no Console do Cloud:

1. Abra a interface da Apigee no Console do Cloud em um navegador.
2. No painel de navegação, selecione Gerenciamento > Coletores de dados.
3. Na visualização Coletores de dados, clique em Criar.
4. Clique em + Criar para exibir a caixa de diálogo Adicionar coletor de dados.
5. Adicione as seguintes informações na caixa de diálogo:
   • Nome: um nome para o coletor de dados.
     Observação: o nome de um coletor de dados precisa começar com dc_.
     Aviso: não crie dois coletores de dados com nomes que diferem apenas por caso, como dc_my_data e dc_My_Data, porque a exportação dos dados resultará em um erro "nomes de colunas duplicados".
   • Tipo: os tipos de dados a serem coletados (Integer, String e assim por diante).
   • Descrição: uma descrição informal dos dados a serem coletados, possivelmente incluindo o motivo da coleta. Isso é para o benefício de outros desenvolvedores de API que possam estar envolvidos na análise dos dados.
6. Clique em ADICIONAR.

Apigee clássica

Para criar um recurso Coletor de dados usando a Apigee clássica:

1. Abra a interface da Apigee em um navegador.

2. No painel de navegação, selecione Administrador > Coletores de dados.

   

   O painel Coletores de dados será exibido.

   

   O painel mostrado acima está vazio porque nenhum coletor de dados foi criado ainda. Agora, crie um novo coletor de dados. Depois que alguns coletores de dados forem criados, clique nos nomes dos coletores para editá-los.

3. Clique em + CRIAR para exibir a caixa de diálogo Adicionar coletor de dados.

   
4. Adicione as seguintes informações na caixa de diálogo:
   • Nome: um nome para o coletor de dados.
     Observação: o nome de um coletor de dados precisa começar com dc_.
     Observação: não crie dois coletores de dados com nomes que diferem apenas por caso, como dc_my_data e dc_My_Data, porque a exportação dos dados resultará em um erro "nomes de colunas duplicados".
   • Tipo: os tipos de dados a serem coletados (Integer, String e assim por diante).
   • Descrição: uma descrição informal dos dados a serem coletados, possivelmente incluindo o motivo da coleta. Isso é para o benefício de outros desenvolvedores de API que possam estar envolvidos na análise dos dados.
5. Clique em ADICIONAR.

O novo coletor de dados aparecerá no painel Coletor de dados.

Para editar ou excluir um coletor de dados, clique nos três pontos no final da linha dele em Ações e selecione Editar ouExcluir.

API Apigee

É possível criar um recurso Coletor de dados usando a API Apigee. Exemplo:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_data_collector",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/ORG/datacollectors"

Em que ORG é o nome da organização. Isso cria um recurso chamado dc_data_collector, que pode ser usado na política DataCapture.

Observações:

• O nome do recurso Coletor de dados precisa começar com o prefixo dc_.
• Se você usar um Coletor de dados em várias políticas, os dados capturados serão substituídos pela última política executada.

Aviso: não crie dois coletores de dados com nomes que diferem apenas no caso, como dc_my_data e dc_My_Data, porque a exportação de dados resultará em um erro de "nomes de colunas duplicados".