Información general sobre las exportaciones de datos de Trace

Beta

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se ofrece información conceptual sobre la exportación de datos de trazas con Cloud Trace. Puede que quiera exportar datos de seguimiento por los siguientes motivos:

• Para almacenar datos de seguimiento durante un periodo superior al periodo de conservación predeterminado de 30 días.

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

  

Cómo funcionan las exportaciones

Para exportar datos, debes crear un receptor para un Google Cloud proyecto. Un sumidero define un conjunto de datos de BigQuery como destino.

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

Propiedades y terminología de los receptores

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

• Nombre: nombre del receptor. Por ejemplo, un nombre podría ser:

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  donde PROJECT_NUMBER es el Google Cloud número de proyecto del receptor y my-sink es el identificador del receptor.

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

  "projects/PROJECT_ID"
  

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

• Destino: un único lugar al que enviar los intervalos de seguimiento. Trace permite exportar trazas a BigQuery. El destino puede ser el proyecto del receptor o cualquier otro proyecto de la misma organización. Google Cloud Google Cloud

  Por ejemplo, un destino válido es:

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

  donde DESTINATION_PROJECT_NUMBER es el Google Cloud número de proyecto del destino y DATASET_ID es el identificador del conjunto de datos de BigQuery.

• Identidad de escritura: nombre de una cuenta de servicio. El propietario del destino de exportación debe conceder permisos de escritura a esta cuenta de servicio en el destino de exportación. Cuando se exportan trazas, Trace adopta esta identidad para la autorización. Para aumentar la seguridad, los nuevos receptores obtienen una cuenta de servicio única:

  [e-mail]
  

  donde PROJECT_NUMBER es el número de tu proyecto Google Cloud en hexadecimal y GENERATED_VALUE es un valor generado aleatoriamente.

  No creas, posees ni gestionas la cuenta de servicio identificada por la identidad de escritura de un sumidero. Cuando creas un receptor, Trace crea la cuenta de servicio que necesita el receptor. Esta cuenta de servicio no se incluirá en la lista de cuentas de servicio de tu proyecto hasta que tenga al menos un enlace de gestión de identidades y accesos. Añade este enlace cuando configures un destino de receptor.

  Para obtener información sobre cómo usar la identidad del escritor, consulta los permisos de destino.

Cómo funcionan los receptores

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

Las trazas que Trace haya recibido antes de que se creara el receptor no se pueden exportar.

Control de acceso

Para crear o modificar un receptor, debes tener uno de los siguientes roles de Gestión de Identidades y Accesos:

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

Para obtener más información, consulta Control de acceso.

Para exportar trazas a un destino, la cuenta de servicio de escritura del sumidero debe tener permiso para escribir en el destino. Para obtener más información sobre las identidades de escritura, consulta la sección Propiedades de sink de esta página.

Cuotas y límites

Cloud Trace utiliza la API de streaming de BigQuery para enviar intervalos de traza al destino. Cloud Trace agrupa las llamadas a la API. Cloud Trace no implementa ningún mecanismo de reintento ni de limitación. Es posible que los intervalos de traza no se exporten correctamente si la cantidad de datos supera las cuotas de destino.

Para obtener más información sobre las cuotas y los límites de BigQuery, consulta Cuotas y límites.

Precios

La exportación de trazas no genera cargos de Cloud Trace. Sin embargo, es posible que se apliquen cargos de BigQuery. Consulta los precios de BigQuery para obtener más información.

Calcular los costes

BigQuery cobra por la ingesta y el almacenamiento de datos. Para calcular tus costes mensuales de BigQuery, haz lo siguiente:

1. Estima el número total de intervalos de traza que se ingieren en un mes.

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

2. Estima los requisitos de streaming en función del número de intervalos de traza ingeridos.

   Cada intervalo se escribe en una fila de la tabla. Cada fila de BigQuery requiere al menos 1024 bytes. Por lo tanto, el límite inferior de tus requisitos de streaming de BigQuery es asignar 1024 bytes a cada intervalo. Por ejemplo, si tu Google Cloud proyecto ha ingerido 200 intervalos, estos requieren al menos 20.400 bytes para la inserción de streaming.

3. Usa la calculadora de precios para estimar los costes de BigQuery derivados del almacenamiento, las inserciones en tiempo real y las consultas.

Ver y gestionar 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 supera los límites predefinidos. En la siguiente tabla se incluyen los ajustes para crear una política de alertas. Puede usar los ajustes de la tabla del panel de segmentación al crear un gráfico o al usar el explorador de métricas.

Para crear una política de alertas que se active cuando las métricas de BigQuery ingeridas superen el nivel que has definido, sigue los pasos que se indican más abajo.

Pasos para crear una política de alertas

Para crear una política de alertas, haz lo siguiente:

1. En la Google Cloud consola, ve a la página  Alertas:

   Ve a Alertas.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

2. Si no has creado tus canales de notificación y quieres recibir notificaciones, haz clic en Editar canales de notificación y añade tus canales de notificación. Vuelve a la página Alertas después de añadir tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, despliega el menú Seleccionar una métrica y, a continuación, usa los valores de la tabla Nueva condición:
   1. Opcional: Para limitar el menú a las entradas relevantes, introduce el nombre del recurso o de la métrica en la barra de filtros.
   2. Selecciona un Tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Seleccione una categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccione una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Aplicar.
5. Haga clic en Siguiente y, a continuación, configure el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alerta.
6. Haz clic en Siguiente.

7. Opcional: Para añadir notificaciones a tu política de alertas, haz clic en Canales de notificación. En el cuadro de diálogo, selecciona uno o más canales de notificación y, luego, haz clic en Aceptar.

   Para recibir notificaciones cuando se abran y se cierren incidentes, marca la opción Notificar cuando se cierre un incidente. De forma predeterminada, las notificaciones solo se envían cuando se abren incidentes.

8. Opcional: Actualiza la duración del cierre automático de incidentes. Este campo determina cuándo cierra Monitoring los incidentes si no hay datos de métricas.
9. Opcional: Haz clic en Documentación y añade la información que quieras incluir en las notificaciones.
10. Haz clic en Nombre de la alerta y escribe el que quieras asignar a la política de alertas.
11. Haz clic enCreate Policy (Crear política).

Campo Nueva condición	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. Seleccione una métrica en el menú Métricas. Entre las métricas específicas del uso se incluyen Stored bytes, Uploaded bytes y Uploaded bytes billed. Para ver una lista completa de las métricas disponibles, consulte Métricas de BigQuery.
Filtro	project_id el ID de tu proyecto Google Cloud . dataset_id: el ID de tu conjunto de datos.
En series temporales Agrupación por serie temporal	dataset_id el ID de tu conjunto de datos.
Entre series temporales Agregación de series temporales	sum
Ventana de tiempo	1 m
Función de ventana móvil	mean

Configurar el activador de alertas Campo	Valor
Tipo de condición	Threshold
Activador de alerta	Any time series violates
Posición del umbral	Above threshold
Valor de umbral	Tú eliges el valor aceptable.
Ventana de repetición de la prueba	1 minute

Siguientes pasos

Para configurar un receptor, consulta Exportar trazas.