Gerir coletores de dados

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Um recurso de recolhedor de dados permite-lhe recolher uma grande variedade de dados personalizados do tráfego da API. Depois de criar um coletor de dados, especifica os dados que quer recolher através da política DataCapture. O coletor de dados é como um carrinho de compras e a política DataCapture é uma lista de compras dos dados que quer capturar.

Nota: se usar um coletor de dados em várias políticas, os dados capturados são substituídos pela última política executada.

Para ver uma lista das quantidades relacionadas com o tráfego da API que pode capturar através do recurso de recolha de dados, consulte Métricas.

Criar um coletor de dados

Pode criar um recurso de coletor de dados na IU do Apigee ou com a API Apigee:

Apigee na Cloud Console

Para criar um recurso de coletor de dados através do Apigee na Cloud Console:

1. Na Google Cloud consola, aceda à página Gestão > Recolhedores de dados.

   Aceda aos coletores de dados

2. Na vista Recolhedores de dados, clique em Criar.
3. Na caixa de diálogo Adicionar coletor de dados, introduza as seguintes informações:
   • Nome: um nome para o coletor de dados.
     Nota: o nome de um coletor de dados tem de começar por dc_.
     Aviso: Não crie dois coletores de dados cujos nomes difiram apenas em maiúsculas/minúsculas, como dc_my_data e dc_My_Data, uma vez que, nesse caso, a exportação de dados vai resultar num erro de "nomes de colunas duplicados".
   • Tipo: o tipo de dados a recolher (Integer, String, e assim sucessivamente).
   • Descrição: uma descrição informal dos dados a recolher, possivelmente incluindo o motivo da recolha. Isto é para benefício de outros programadores de APIs que possam estar envolvidos na análise dos dados.
4. Clique em Adicionar.

Apigee clássico

Para criar um recurso de coletor de dados com o Apigee clássico:

1. Abra a IU do Apigee num navegador.

2. Selecione Administração > Recolhedores de dados no painel de navegação.

   

   É apresentado o painel de coletores de dados.

   

   O painel apresentado acima está vazio porque ainda não foram criados coletores de dados. Neste ponto, pode criar um novo coletor de dados. Depois de criar alguns coletores de dados, pode clicar nos respetivos nomes no painel para os editar.

3. Clique em + CRIAR para apresentar 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.
     Nota: o nome de um coletor de dados tem de começar por dc_.
     Nota: Não crie dois coletores de dados cujos nomes difiram apenas em maiúsculas/minúsculas, como dc_my_data e dc_My_Data, pois, nesse caso, a exportação de dados vai resultar num erro de "nomes de colunas duplicados".
   • Tipo: o tipo de dados a recolher (Integer, String, e assim sucessivamente).
   • Descrição: uma descrição informal dos dados a recolher, possivelmente incluindo o motivo da recolha. Isto é para benefício de outros programadores de APIs que possam estar envolvidos na análise dos dados.
5. Clique em Adicionar.

O novo coletor de dados é apresentado no painel Coletor de dados.

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

API Apigee

Pode criar um recurso de coletor de dados através da API Apigee. Por 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. Isto cria um recurso denominado dc_data_collector, que pode usar na política DataCapture.

Notas:

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

Aviso: não crie dois coletores de dados cujos nomes difiram apenas em maiúsculas/minúsculas, como dc_my_data e dc_My_Data, pois, nesse caso, a exportação de dados vai resultar num erro de "nomes de colunas duplicados".