Migra a las operaciones en la nube para GKE

Hay dos opciones de asistencia de Monitoring y Logging en Google Kubernetes Engine (GKE). Todas las versiones de GKE disponibles para los clústeres nuevos y las actualizaciones de los clústeres existentes las ofrecen:

• Logging y Monitoring heredados: Para ver la documentación, consulta las páginas Monitoring heredado y Logging heredado.

• Operaciones en la nube para GKE: Consulta Operaciones en la nube para GKE a fin de obtener documentación.

En esta página, se explican las diferencias entre estas dos opciones y lo que debes cambiar con el fin de migrar de Logging y Monitoring heredados a operaciones en la nube para GKE.

Precaución: La asistencia de Logging y Monitoring heredados y las operaciones en la nube para GKE no son compatibles. A fin de actualizar a las operaciones en la nube para GKE, debes cambiar de forma manual la configuración de Monitoring y Logging, incluidas, entre otras, las políticas de alertas, los gráficos, los filtros de grupo y las consultas de registros.

¿Cuándo debo migrar?

Puedes migrar la configuración existente de Cloud Monitoring y Cloud Logging desde Logging y Monitoring heredados hasta las operaciones en la nube para GKE en cualquier momento. Sin embargo, ten en cuenta que una próxima actualización de GKE podría anular la asistencia para Logging y Monitoring heredados. Si se quita la asistencia para Logging y Monitoring heredados, debes migrar a las operaciones en la nube para GKE antes de esa fecha si quieres continuar usando la asistencia de Cloud Monitoring y Cloud Logging.

Nota: Si cambias la versión de GKE de tu clúster, no se modificará la asistencia de Monitoring y Logging configurada. Consulta la sección ¿qué asistencia de Monitoring y Logging usa mi clúster? a fin de determinar la asistencia actual de tu clúster.

En la siguiente tabla, se resumen las próximas versiones previstas de GKE con sus opciones de asistencia:

Versión de GKE	Logging y Monitoring heredados	Operaciones en la nube para GKE
1.10-1.12.5	Predeterminado	Habilitación opcional (Beta)
1.12.7	Predeterminado	Opcional
1.13	Predeterminado	Opcional
1.14	Opcional	Predeterminado
1.15	No disponible	Valor predeterminado

Si deseas obtener información sobre la baja de Logging y Monitoring heredados, consulta la guía Asistencia heredada para la baja de GKE.

¿Qué aspectos cambiarán?

Las operaciones en la nube para GKE usan un modelo de datos diferente a fin de organizar las métricas, los registros y los metadatos. Estos son algunos de los cambios específicos en los clústeres que usan operaciones en la nube para GKE:

• Cambios en la navegación: Los paneles de Cloud Monitoring se llaman Kubernetes Engine New. Este panel no aparecerá si no tienes clústeres que usen operaciones en la nube para GKE.

• Cambios en los nombres de tipos de recursos supervisados: por ejemplo, tus nodos de Kubernetes se enumeran en el tipo de recurso supervisado k8s_node, que es un nodo de Kubernetes, en lugar de gce_instance (instancia de VM de Compute Engine).

• Cambios en los nombres de las métricas de Kubernetes: En las operaciones en la nube para GKE, los nombres de tipos de métricas ahora comienzan con el prefijo kubernetes.io/ en lugar de container.googleapis.com/.

En la siguiente tabla, se resumen los cambios mencionadas antes:

Cambio	Logging y Monitoring heredados (antiguo)	Operaciones en la nube para GKE (nuevo)
Menús del panel	Paneles > Kubernetes Engine	Paneles > Kubernetes Engine New
Prefijos de métricas	container.googleapis.com	kubernetes.io
Tipos de recursos	gke_container (métricas) container (registros) gce_instance (ninguno) gke_cluster	k8s_container k8s_container k8s_node k8s_pod k8s_cluster

¿Qué debo hacer?

En esta sección, se incluye información más específica sobre los cambios del modelo de datos en las operaciones en la nube para GKE y su impacto en la configuración existente de Monitoring y Logging.

Nota: Después de actualizar un clúster, asegúrate de buscar los datos de supervisión solo a través de los nombres nuevos de tipos de recursos. Es posible que aún veas los tipos de recursos heredados, pero solo almacenarán los datos de supervisión anteriores a la actualización de tus clústeres.

Usa el panel de estado de migración

A fin de obtener información sobre los cambios que debes realizar en la configuración de Logging como parte de la migración a las operaciones en la nube para GKE, consulta Actualizaciones de la configuración de Logging.

A fin de identificar los parámetros de configuración de Cloud Monitoring que debes actualizar como parte de la migración a las operaciones en la nube para GKE, haz lo siguiente:

1. En Cloud Console, ve a Monitoring:

   Ir a Monitoring

2. En el panel de navegación de Monitoring, haz clic en Configuración (Settings) y, luego, selecciona la pestaña Kubernetes Migration Status.

En el siguiente panel de ejemplo, se muestra que debe actualizarse 1 política de alertas:

Cambios en los tipos de recursos

Las operaciones en la nube para GKE tienen nuevos nombres de tipos de recursos, nuevos nombres visibles de tipos de recursos y nombres nuevos para las etiquetas que identifican recursos específicos. Estos cambios se enumeran en la siguiente tabla.

Cambios en los tipos de recursos

Tipo de recurso de Logging y Monitoring heredados (antiguo)	Tipos de recursos de las operaciones en la nube para GKE (nuevo)
Notas al pie de la tabla: ^1 En el tipo de recurso nuevo usado (solo) en la supervisión, instance_id se convierte en node_name en metadata.system_labels. ^2zone hace referencia a la ubicación de este contenedor o instancia. location hace referencia a la ubicación del nodo de la instancia principal del clúster. ^3metadata.system_labels.node_name no está disponible en los tipos de recursos k8s_container utilizados para los registros. No puedes buscar registros por nombre de nodo. ^4 El tipo de recurso gce_instance puede representar nodos de Kubernetes, así como instancias de VM que no son de Kubernetes. Cuando se actualiza a las operaciones en la nube para GKE, los usos relacionados con nodos se cambian a fin de usar el tipo de recurso nuevo, k8s_node, incluidos los registros a nivel de nodo con los siguientes nombres: kubelet, docker, kube-proxy, startupscript y node-problem-detector. ^5 Los nodos k8s_pod y k8s_cluster pueden incluir registros que no están presentes en la asistencia de Logging y Monitoring heredados.
Solo Monitoring: gke_container (contenedor de GKE) Etiquetas:   cluster_name   container_name   instance_id^1   namespace_id   pod_id   project_id   zone^2 Solo Logging: container (contenedor de GKE) Etiquetas:   cluster_name   container_name   instance_id^1   namespace_id   pod_id   project_id   zone^2	Monitoring y Logging: k8s_container (contenedor de Kubernetes) Etiquetas:   cluster_name   container_name   metadata.system_labels.node_name^3   namespace_name   pod_name   project_id   location^2
Solo Logging:: gce_instance (instancia de VM de Compute Engine) ^4 Etiquetas:   cluster_name   instance_id   project_id   zone^2	Monitoring y Logging: k8s_node^4 (nodo de Kubernetes) Etiquetas:   cluster_name   node_name   project_id   location^2
(ninguno)	Monitoring y Logging: k8s_pod^5 (pod de Kubernetes) Etiquetas:   cluster_name   namespace_name   pod_name   project_id   location^2
Solo Logging gke_cluster (GKE_cluster) Etiquetas:   cluster_name   project_id   location	Monitoring y Logging: k8s_cluster^5 (clúster de Kubernetes) Etiquetas:   cluster_name   project_id   location

Cambios en los nombres de las métricas

En la siguiente tabla, se muestran algunos ejemplos de nombres de métricas. Debes cambiar cada uso de una métrica cuyo nombre comience con container.googleapis.com/ por una métrica nueva cuyo nombre comience con kubernetes.io/.

Los nombres nuevos de las métricas pueden variar según otros criterios además del prefijo nuevo. Busca las métricas nuevas en kubernetes.io .

Cambios en los nombres de las métricas

Métricas de Logging y Monitoring heredados (antiguo)	Métricas de las operaciones en la nube para GKE (nuevo)
Métricas de GKE heredado container.googleapis.com/ Ejemplos:   .../container/cpu/utilization   .../container/uptime   .../container/memory/bytes_total	Métricas de Kubernetes Engine Monitoring kubernetes.io/ Ejemplos:   .../container/cpu/request_utilization   .../container/uptime   .../node/memory/total_bytes   .../node/cpu/total_cores

Cambios en los grupos de recursos

Si defines tus propios grupos de recursos y usas cualquiera de los tipos de recursos de Logging y Monitoring heredados que aparecen en la tabla anterior Cambios en los tipos de recursos o cualquier métrica de Logging y Monitoring heredados que aparece en la tabla anterior Cambios en los nombres de las métricas, cambia esos tipos y esas métricas a las operaciones en la nube correspondientes a los tipos de recursos y métricas de GKE. Si tu grupo de recursos incluye gráficos personalizados, es posible que debas cambiarlos.

Nota: Comprueba que los grupos actualizados contengan la misma cantidad de recursos que tenían antes de la actualización. Si usas pocos recursos, es posible que hayas pasado por alto algunos cambios.

Cambios en los paneles y los gráficos personalizados

Si defines tus propios gráficos y paneles personalizados y usas cualquiera de los tipos de recursos de Logging y Monitoring heredados que aparecen en la tabla anterior Cambios en los tipos de recursos o cualquier métrica heredada de Logging y Monitoring que aparece en la tabla anterior Cambios en los nombres de las métricas, cambia esos tipos y métricas por los tipos y métricas de las operaciones en la nube para GKE correspondientes.

Nota: Comprueba que los gráficos actualizados reciban datos con marcas de tiempo después de la actualización. Si faltan datos, es posible que no hayas cambiado algunas métricas correctamente.

Si deseas obtener ayuda con los paneles y los gráficos personalizados, consulta el panel de estado de migración de GKE:

1. En Cloud Console, selecciona el proyecto de Google Cloud que contenga un clúster de GKE a fin de actualizar a las operaciones en la nube para GKE:

   Ir a Cloud Console

2. Selecciona Monitoring.

3. Para acceder al estado de la migración, en el panel de navegación de Monitoring, haz clic en Configuración y, luego, selecciona la pestaña Kubernetes Migration Status.

Cambios en las políticas de alertas y tiempo de actividad

Si defines políticas de alertas o verificaciones de tiempo de actividad y usas cualquiera de los tipos de recursos de Logging y Monitoring heredados que aparecen en la tabla anterior Cambios de tipos de recursos o cualquier las métrica heredada de Logging y Monitoring que aparece en la tabla anterior Cambios en los nombres de las métricas, cambia esos tipos y métricas por los tipos y las métricas de operaciones en la nube correspondientes a los tipos y las métricas de GKE.

La actualización de las políticas de alertas y las verificaciones de tiempo de actividad pueden ser los cambios más difíciles de realizar y verificar. Una pregunta que debes tener en cuenta es cuándo realizar estos cambios. ¿Debes cambiar la configuración de tu política antes o después de actualizar el clúster? Las políticas anteriores fallarán después de actualizar el clúster, y las nuevas lo harán antes de realizar dicha actualización.

En lugar de cambiar las políticas implementadas, puedes dejar las políticas existentes sin modificarlas y crear políticas nuevas con los cambios actualizados. Esto podría facilitar el seguimiento de las políticas que se espera que fallen y las que no en diferentes momentos de la actualización.

A continuación, se brindan las siguientes sugerencias:

• Revisa tus políticas y calcula durante cuánto tiempo tendrá que ejecutarse el clúster actualizado antes de que hayas acumulado suficientes datos para que funcione en el estado estable.

• Se recomienda que conozcas el rendimiento de las políticas o las métricas individuales antes de realizar la actualización, de modo que puedas comparar ese comportamiento con el que surja después a la actualización.

Actualizaciones de la configuración de Logging

En esta sección, se describen los cambios que debes realizar en la configuración de Cloud Logging como parte de una migración a las operaciones en la nube para GKE.

Consultas de Logging

Si usas consultas para buscar y filtrar tus registros en Cloud Logging y usas cualquiera de los tipos de recursos de Logging y Monitoring heredados que se muestran en la tabla anterior Cambios en los tipos de recursos, cambia esos tipos por los tipos correspondientes de las operaciones en la nube para GKE.

Métricas basadas en registros

Si defines tus propias métricas basadas en registros y usas métricas o tipos de recursos de Logging y Monitoring heredados que se muestran en las tablas anteriores Cambios en los nombres de las métricas o Cambios en los tipos de recursos, cambia esas métricas y tipos de recursos a los correspondientes de las operaciones en la nube para GKE.

Nota: Si no ves muestras de tus métricas basadas en registros después de actualizar a las operaciones en la nube para GKE, es posible que todavía estés usando las métricas o los tipos de recursos de Logging y Monitoring heredados.

Exportaciones y exclusiones de registros

Si exportas o excluyes cualquiera de los registros y si los filtros de exportación o exclusión usan tipos de recursos de Logging y Monitoring heredados que se muestran en la tabla anterior Cambios en los tipos de recursos, cambia los filtros de exclusión y exportación a fin de usar los tipos de recursos correspondientes de las operaciones en la nube para GKE.

Nota: Antes de actualizar a las operaciones en la nube para GKE, toma nota de la cantidad aproximada de entradas de registro que exportas o excluyes de tu proyecto de GCP, así verificas que aún recibes una cantidad adecuada.

Cambios en el contenido de las entradas de registro

Cuando actualizas a las operaciones en la nube para GKE, es posible que descubras que cierta información de las entradas de registro se trasladó a campos con nombres diferentes. Esta información puede aparecer en las consultas de registros usadas en las métricas basadas en registros, los receptores de registros y las exclusiones de registros.

En la siguiente tabla, Cambios en la entrada de registro, se enumeran las etiquetas y los campos nuevos. A continuación, presentamos un breve resumen:

• El campo logName puede cambiar. Las entradas de registro de las operaciones en la nube para GKE usan stdout o stderr en sus nombres de registro, mientras que Logging y Monitoring heredados usan una variedad más amplia de nombres, incluido el nombre del contenedor. El nombre del contenedor aún está disponible como etiqueta de recurso.
• Comprueba el campo labels en las entradas de registro. Es posible que este campo contenga información que anteriormente se encontraba en los campos de entrada de registro metadata.
• Comprueba el campo resource.labels en las entradas de registro. Los tipos de recursos nuevos tienen valores de etiqueta adicionales.

Cambios en las entradas de registro

Entradas de registro de Logging y Monitoring heredados (antiguo)	Entradas de registro de las operaciones en la nube para GKE (nuevo)
Notas al pie de tabla: ^1 Las etiquetas de recursos identifican recursos específicos que generan métricas, como clústeres y nodos determinados. ^2 El campo labels aparece en entradas de registro nuevas que forman parte de operaciones en la nube para GKE y, en ocasiones, en algunas entradas de registro de Logging y Monitoring heredados. En las operaciones en la nube para GKE, se usa a fin de almacenar información que antes se encontraba en los campos de entrada de registro metadata.
Recursos de entrada de registro resource.labels (etiquetas de recursos ^1)	Recursos de entrada de registro resource.labels (etiquetas de recursos ^1)
Metadatos de entrada de registro labels(etiquetas de entrada de registro ^2) etiquetas (ejemplos)   compute.googleapis.com/resource_name:     "fluentd-gcp-v3.2.0-d4d9p"   container.googleapis.com/namespace_name:     "kube-system"   container.googleapis.com/pod_name:     "fluentd-gcp-scaler-8b674f786-d4pq2"   container.googleapis.com/stream:     "stdout"	Metadatos de entrada de registro labels

Cambios en las ubicaciones de los registros

En Cloud Logging, los registros se almacenan con el tipo de recurso que los generó. Debido a que estos tipos cambiaron en las operaciones en la nube para GKE, asegúrate de buscar los registros en los tipos de recursos nuevos, como Kubernetes Container, en lugar de hacerlo en los tipos de Logging y Monitoring heredados, como GKE Container.

Próximos pasos

• A fin de obtener más información sobre el panel nuevo de operaciones en la nube para GKE, consulta Observa tu sistema.