Administra recopiladores de datos

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Un recurso de recopilador de datos te permite recopilar una amplia variedad de datos personalizados del tráfico de API. Una vez que hayas creado un recopilador de datos, debes especificar los datos que deseas recopilar mediante la política DataCapture. El recolector de datos es como un carrito de compras, y la política DataCapture es una lista de compras para los datos que deseas capturar.

Nota: Si usas un recopilador de datos en varias políticas, la última política que se ejecuta reemplazará los datos capturados.

Para obtener una lista de las cantidades relacionadas con el tráfico de API que puedes capturar con el recurso del recopilador de datos, consulta Métricas.

Crea un recopilador de datos

Puedes crear un recurso de recopilador de datos en la IU de Apigee o con la API de Apigee:

Nota: Hay una versión nueva de la IU de Apigee, que está integrada en la consola de Google Cloud. La IU nueva se llama Apigee en la consola de Cloud. En las instrucciones de las dos primeras pestañas a continuación, se explica cómo usar Apigee en la consola de Cloud o la versión clásica de Apigee.

Apigee en la consola de Cloud

Para crear un recurso de recopilador de datos con Apigee en Cloud Console, sigue estos pasos:

1. Abre la IU de Apigee en la consola de Cloud en un navegador.
2. Selecciona Administrador > Recopiladores de datos en el panel de navegación.
3. En la vista Recopiladores de datos, haz clic en Crear.
4. Haz clic en + Crear para abrir el cuadro de diálogo Agregar colector de datos.
5. Agrega la siguiente información en el diálogo:
   • Nombre: Es un nombre para el recolector de datos.
     Nota: Es el nombre de un recopilador de datos debe comenzar con dc_.
     Advertencia: No crees dos recopiladores de datos cuyos nombres solo difieran en las mayúsculas, como dc_my_data y dc_My_Data, ya que luego exportar datos dará como resultado un error de “nombres de columnas duplicados”.
   • Tipo: el tipo de datos que se recopilarán (Integer, String, etcétera).
   • Descripción: Una descripción informal de los datos que se recopilarán, aunque puede incluir el motivo de la recopilación. Esto es para beneficio de otros desarrolladores de API que pueden estar involucrados en el análisis de los datos.
6. Haga clic en AGREGAR.

Apigee clásico

Para crear un recurso de recopilador de datos mediante la versión clásica de Apigee, haz lo siguiente:

1. Abre la IU de Apigee en un navegador.

2. Selecciona Administrador > Recopiladores de datos en el panel de navegación.

   

   Se mostrará el panel de recolectores de datos.

   

   El panel que se muestra arriba está vacío porque aún no se han creado los recopiladores de datos. En este punto, puedes crear un nuevo recopilador de datos. Una vez creados los recopiladores de datos, puedes hacer clic en sus nombres en el panel para editarlos.

3. Haz clic en + CREAR para abrir el cuadro de diálogo Agregar colector de datos.

   
4. Agrega la siguiente información en el diálogo:
   • Nombre: Es un nombre para el recolector de datos.
     Nota: Es el nombre de un recopilador de datos debe comenzar con dc_.
     Nota: No crees dos recopiladores de datos cuyos nombres solo difieran en las mayúsculas, como dc_my_data y dc_My_Data, ya que luego exportar datos dará como resultado un error de “nombres de columnas duplicados”.
   • Tipo: el tipo de datos que se recopilarán (Integer, String, etcétera).
   • Descripción: Una descripción informal de los datos que se recopilarán, aunque puede incluir el motivo de la recopilación. Esto es para beneficio de otros desarrolladores de API que pueden estar involucrados en el análisis de los datos.
5. Haga clic en AGREGAR.

El nuevo recopilador de datos aparecerá en el panel Recopilador de datos.

Para editar o borrar un recolector de datos, haz clic en los tres puntos al final de la fila debajo de Acciones, y selecciona Editar o Borrar.

API de Apigee

Puedes crear un recurso de recopilador de datos con la API de Apigee. Por ejemplo:

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"

en el que ORG es el nombre de la organización. Esto crea un recurso llamado dc_data_collector, que puedes usar en la política DataCapture.

Notas:

• El nombre del recurso del recopilador de datos debe comenzar con el prefijo dc_.
• Si usas un recopilador de datos en varias políticas de DataCapture, la última política que se ejecuta reemplazará los datos capturados.

Advertencia: No crees dos recopiladores de datos cuyos nombres solo difieran en las mayúsculas, como dc_my_data y dc_My_Data, ya que luego exportar datos dará como resultado un error de “nombres de columna duplicados”.