Gestionar recopiladores de datos

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

Consulta la documentación de Apigee Edge.

Un recurso de recogida de datos le permite recoger una amplia variedad de datos personalizados del tráfico de la API. Una vez que hayas creado un recolector de datos, especifica los datos que quieras recoger mediante la política DataCapture. El recolector de datos es como un carrito de la compra, y la política DataCapture es una lista de la compra de los datos que quieres recoger.

Nota: Si usas un recopilador de datos en varias políticas, los datos recogidos se sobrescribirán con la última política que se ejecute.

Para ver una lista de las cantidades relacionadas con el tráfico de la API que puede registrar con el recurso de recopilador de datos, consulte Métricas.

Crear un recopilador de datos

Puede crear un recurso de recopilador de datos en la interfaz de usuario de Apigee o con la API de Apigee:

Apigee en la consola de Cloud

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

1. En la Google Cloud consola, ve a la página Gestión > Recopiladores de datos.

   Ir a Recogida de datos

2. En la vista Recogida de datos, haga clic en Crear.
3. En el cuadro de diálogo Añadir recolector de datos, introduce la siguiente información:
   • Nombre: el nombre del recopilador de datos.
     Nota: El nombre de un recopilador de datos debe empezar por dc_.
     Advertencia: No cree dos colectores de datos cuyos nombres solo se diferencien en el uso de mayúsculas y minúsculas, como dc_my_data y dc_My_Data, ya que, de lo contrario, al exportar los datos se producirá un error de "nombres de columna duplicados".
   • Tipo: el tipo de datos que se va a recoger (Integer, String, etcétera).
   • Descripción: descripción informal de los datos que se van a recoger, posiblemente incluyendo el motivo de la recogida. Esto es para beneficio de otros desarrolladores de APIs que puedan participar en el análisis de los datos.
4. Haz clic en Añadir.

Apigee Classic

Para crear un recurso de recopilador de datos con Apigee Classic, sigue estos pasos:

1. Abre la interfaz de usuario de Apigee en un navegador.

2. En el panel de navegación, seleccione Administrar > Recogida de datos.

   

   Se muestra el panel Recopiladores de datos.

   

   El panel que se muestra arriba está vacío porque aún no se ha creado ningún recopilador de datos. En este punto, puede crear un nuevo recopilador de datos. Una vez que haya creado algunos colectores de datos, puede hacer clic en sus nombres en el panel para editarlos.

3. Haga clic en + CREAR para mostrar el cuadro de diálogo Añadir recolector de datos.

   
4. Añade la siguiente información en el cuadro de diálogo:
   • Nombre: el nombre del recopilador de datos.
     Nota: El nombre de un recopilador de datos debe empezar por dc_.
     Nota: No cree dos colectores de datos cuyos nombres solo se diferencien en el uso de mayúsculas y minúsculas, como dc_my_data y dc_My_Data, ya que, de lo contrario, al exportar los datos se producirá un error de "nombres de columna duplicados".
   • Tipo: el tipo de datos que se va a recoger (Integer, String, etcétera).
   • Descripción: descripción informal de los datos que se van a recoger, posiblemente incluyendo el motivo de la recogida. Esto es para beneficio de otros desarrolladores de APIs que puedan participar en el análisis de los datos.
5. Haz clic en Añadir.

El nuevo recopilador de datos aparece ahora en el panel Recopilador de datos.

Para editar o eliminar un recolector de datos, haz clic en los tres puntos situados al final de su fila en Acciones y selecciona Editar o Eliminar.

API de Apigee

Puedes crear un recurso recopilador de datos mediante 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"

donde ORG es el nombre de la organización. De esta forma, se 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 empezar por el prefijo dc_.
• Si usas un recolector de datos en varias políticas de DataCapture, los datos recogidos se sobrescribirán con la última política que se ejecute.

Advertencia: No cree dos colectores de datos cuyos nombres solo se diferencien en el uso de mayúsculas y minúsculas, como dc_my_data y dc_My_Data, ya que, de lo contrario, al exportar los datos se producirá un error de "nombres de columna duplicados".