Descripción general de las exportaciones de datos de seguimiento

Beta

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se proporciona una descripción general conceptual de la exportación de datos de seguimiento con Cloud Trace. Es posible que quieras exportar los datos de seguimiento por los siguientes motivos:

• Para almacenar datos de seguimiento durante un período más largo que el período de retención predeterminado de 30 días.

• Permitirte usar las herramientas de BigQuery para analizar los datos de seguimiento Por ejemplo, con BigQuery, puedes identificar los recuentos de intervalos y cuantiles. Si quieres obtener información sobre la consulta que se usó para generar la siguiente tabla, revisa la consulta de HipsterShop.

  

Cómo funcionan las exportaciones

La exportación implica crear un receptor para un proyecto de Google Cloud. Un receptor define un conjunto de datos de BigQuery como destino.

Puedes crear un receptor con la API de Cloud Trace o Google Cloud CLI.

Terminología y propiedades de los receptores

Los receptores se definen para un proyecto de Google Cloud y tienen las siguientes propiedades:

• Nombre: un nombre para el receptor. Por ejemplo, el siguiente podría ser un nombre:

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  En el ejemplo anterior, PROJECT_NUMBER es el número del proyecto de Google Cloud del receptor y my-sink es el identificador del receptor.

• Recurso superior: el recurso en el que se crea el receptor. El recurso superior debe ser un proyecto de Google Cloud:

  "projects/PROJECT_ID"
  

  PROJECT_ID puede ser un número o un identificador de proyecto de Google Cloud.

• Destino: Es un único lugar al que se envían los intervalos de seguimiento. Trace admite la exportación de seguimientos a BigQuery. El destino puede ser el proyecto de Google Cloud del receptor o cualquier otro proyecto de Google Cloud que se encuentre en la misma organización.

  Por ejemplo, el siguiente es un destino válido:

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  En el ejemplo anterior, DESTINATION_PROJECT_NUMBER es el número del proyecto de Google Cloud del destino y DATASET_ID es el identificador del conjunto de datos de BigQuery.

• Identidad del escritor: un nombre de cuenta de servicio. El propietario del destino de exportación debe otorgarle permisos a esta cuenta de servicio para escribir en el destino de exportación. Cuando exportas seguimientos, Trace adopta esta identidad para su autorización. Para mayor seguridad, los receptores nuevos obtienen una cuenta de servicio única:

  [e-mail]
  

  En el ejemplo anterior, PROJECT_NUMBER es el número de tu proyecto de Google Cloud, en Hex, y GENERATED_VALUE es un valor generado aleatoriamente.

  No creas, no posees ni administras la cuenta de servicio que identifica la identidad de escritor de un receptor. Cuando creas un receptor, Trace crea la cuenta de servicio que requiere el receptor. Esta cuenta de servicio no se incluye en la lista de cuentas de servicio de tu proyecto hasta que tenga al menos una vinculación de Identity and Access Management. Agrega esta vinculación cuando configuras un destino de receptor.

  Para obtener información sobre el uso de la identidad del escritor, consulta permisos de destino.

Cómo funcionan los receptores

Cada vez que llega un intervalo de seguimiento a un proyecto, Trace exporta una copia del intervalo.

Los seguimientos que recibió Trace antes de que se creara el receptor no se pueden exportar.

Control de acceso

Para crear o modificar un receptor, debes tener una de las siguientes funciones de Identity and Access Management:

• Administrador de Trace
• Usuario de seguimiento
• Propietario del proyecto
• Editor de proyecto

Para obtener más información, consulta Guía de control de acceso.

Para exportar seguimientos a un destino, la cuenta de servicio del escritor del receptor debe tener permisos de escritura en el destino. Para obtener más información sobre las identidades de los escritores, consulta la sección Propiedades de los receptores en esta página.

Cuotas y límites

Cloud Trace utiliza la API de transmisión de BigQuery para enviar intervalos de seguimiento al destino. Cloud Trace agrupa en lotes las llamadas a la API. Cloud Trace no implementa un mecanismo de reintento o limitación. Es posible que los intervalos de seguimiento no se exporten correctamente si la cantidad de datos excede las cuotas de destino.

Para obtener detalles sobre las cuotas y los límites de BigQuery, consulta Cuotas y límites.

Precios

Exportar seguimientos no genera cargos de Cloud Trace. Sin embargo, es posible que se generen cargos de BigQuery. Consulta la sección sobre precios de BigQuery para obtener más información.

Estima tus costos

BigQuery cobra por la transferencia y el almacenamiento de datos. Para estimar los costos mensuales de BigQuery, haz lo siguiente:

1. Estima la cantidad total de intervalos de seguimiento que se transfieren en un mes.

   Para obtener información sobre cómo ver el uso, consulta Visualiza el uso por cuenta de facturación.

2. Estima los requisitos de transmisión según la cantidad de intervalos de seguimiento transferidos.

   Cada intervalo se escribe en una fila de la tabla. Cada fila en BigQuery requiere al menos 1,024 bytes. Por lo tanto, un límite inferior en tus requisitos de transmisión de BigQuery es asignar 1,024 bytes a cada intervalo. Por ejemplo, si tu proyecto de Google Cloud transfirió 200 intervalos, esos intervalos requieren al menos 20,400 bytes para la inserción de transmisión.

3. Usa la calculadora de precios para estimar los costos de BigQuery que generan las inserciones de transmisión, el almacenamiento y las consultas.

Visualiza y administra el uso de BigQuery

Puedes usar el Explorador de métricas para ver tu uso de BigQuery. También puedes crear una política de alertas que te notifique si tu uso de BigQuery excede los límites predefinidos. En la siguiente tabla, encontrarás la configuración para crear una política de alertas. Puedes usar la configuración en la tabla del panel de destino cuando crees un gráfico o uses el Explorador de métricas.

Para crear una política de alertas que se active cuando las métricas de BigQuery transferidas superen un nivel definido por el usuario, usa la siguiente configuración.

Pasos para crear una política de alertas.

Para crear una política de alertas, sigue estos pasos:

1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

   Ir a las Alertas

2. Si aún no creas canales de notificaciones y deseas recibir notificaciones, haz clic en Edit Notification Channels y agrega tus canales de notificaciones. Regresa a la página Alertas después de agregar tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, expande el menú Seleccionar una métrica y, luego, usa los valores de la tabla Condición nueva:
   1. Opcional: Para limitar el menú a entradas relevantes, ingresa el nombre del recurso o la métrica en la barra de filtros.
   2. Selecciona un tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Selecciona una Categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccionar una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Apply (Apply).
5. Haz clic en Siguiente y, luego, configura el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alertas.
6. Haz clic en Siguiente.

7. Para agregar notificaciones a tu política de alertas, haz clic en Canales de notificaciones (opcional). En el diálogo, selecciona uno o más canales de notificaciones del menú y, luego, haz clic en Aceptar.

   Si deseas recibir notificaciones cuando se abran y se cierren incidentes, marca Notificar el cierre de incidentes. De forma predeterminada, se envían notificaciones solo cuando los incidentes se abren.

8. Opcional: Actualiza la Duración del cierre automático de incidentes. Este campo determina cuándo Monitoring cierra los incidentes ante la ausencia de datos de métricas.
9. Opcional: Haz clic en Documentación y, luego, agrega la información que deseas incluir en un mensaje de notificación.
10. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
11. Haga clic en Crear política.

Nueva condición Campo	Valor
Recurso y métrica	En el menú Recursos, selecciona Conjunto de datos de BigQuery. En el menú Categorías de métricas, selecciona Almacenamiento. Selecciona una métrica en el menú Métricas. Las métricas específicas del uso incluyen Stored bytes, Uploaded bytes y Uploaded bytes billed. Para obtener una lista completa de las métricas disponibles, consulta Métricas de BigQuery.
Filtro	project_id: Es el ID de tu proyecto de Google Cloud. dataset_id: Es el ID de tu conjunto de datos.
Series temporales Grupo de series temporales por	dataset_id: Es el ID de tu conjunto de datos.
Series temporales Agregación de series temporales	sum
Ventana progresiva	1 m
Función analítica progresiva	mean

Configura el activador de alertas Campo	Valor
Tipo de condición	Threshold
Activador de alertas	Any time series violates
Posición del umbral	Above threshold
Valor del umbral	Tú determinas el valor aceptable.
Período para volver a probar	1 minute

¿Qué sigue?

Para configurar un receptor, consulta Exporta seguimientos.