Descripción general de las exportaciones de datos de seguimiento

Beta

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

En esta página, se proporciona una descripción general conceptual de la exportación de datos de seguimiento con Cloud Trace. Te recomendamos que exportes 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.

• Para que puedas usar las herramientas de BigQuery para analizar tus datos de seguimiento. Por ejemplo, con BigQuery, puedes identificar recuentos de intervalo y cuantiles. Para obtener información sobre la consulta que se usó para generar la siguiente tabla, consulta Consulta de HipsterShop.

  

Cómo funcionan las exportaciones

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

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

Propiedades y terminologías 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 Google Cloud número del proyecto del receptor y my-sink es el identificador del receptor.

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

  "projects/PROJECT_ID"
  

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

• Destino: Un único lugar para enviar intervalos de seguimiento. Trace admite la exportación de seguimientos a BigQuery. El destino puede ser el Google Cloud proyecto del receptor o cualquier otro Google Cloud proyecto que esté 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 proyectoGoogle Cloud del destino y DATASET_ID es el identificador del conjunto de datos de BigQuery.

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

  [e-mail]
  

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

  No creas, 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 este requiere. 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. Agregas esta vinculación cuando configuras un destino de sink.

  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 expulsa una copia del intervalo.

No se pueden exportar los seguimientos que recibió Trace antes de que se creara el receptor.

Control de acceso

Para crear o modificar un receptor, debes tener uno de los siguientes roles de Identity and Access Management:

• Administrador de Trace
• Usuario de Trace
• 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 usa la API de transmisión de BigQuery para enviar intervalos de seguimiento al destino. Cloud Trace agrupa las llamadas a la API. Cloud Trace no implementa un mecanismo de reintento ni limitación. Es posible que los intervalos de seguimiento no se exporten correctamente si la cantidad de datos supera las cuotas de destino.

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

Precios

La exportación de 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 de BigQuery requiere al menos 1,024 bytes. Por lo tanto, un límite inferior para tus requisitos de transmisión de BigQuery es asignar 1,024 bytes a cada intervalo. Por ejemplo, si tu proyecto Google Cloud transfirió 200 períodos, esos períodos 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 el uso de BigQuery supera los límites predefinidos. En la siguiente tabla, se incluye la configuración para crear una política de alertas. Puedes usar la configuración de 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 la consola de Google Cloud, ve a la página  Alertas.

   Ir a las Alertas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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 del menú Métricas. Las métricas específicas para el 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 Google Cloud ID de tu proyecto. 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.