Migración a Kubernetes Monitoring

En esta página, se explica cómo Stackdriver Kubernetes Monitoring usa métricas, tipos de recursos y registro. También explica cómo esta versión es incompatible con la asistencia heredada de Stackdriver de Google Analytics y cómo puedes migrar de la asistencia más antigua a la más nueva.

Incompatibilidades

La asistencia nueva de Stackdriver Kubernetes Monitoring tiene las siguientes diferencias que afectan la forma en que usas Stackdriver.

  • La interfaz de usuario de Stackdriver Kubernetes Monitoring es diferente. Puedes acceder a ella a través del menú de navegación Recursos > Beta de Kubernetes en Stackdriver Monitoring. Los únicos clústeres que se ven son aquellos que usan Stackdriver Kubernetes Monitoring. No se ve el elemento de menú si no tienes ninguno de estos clústeres.

  • Stackdriver Kubernetes Monitoring tiene un conjunto diferente de métricas.

  • Stackdriver Kubernetes Monitoring tiene un conjunto diferente de tipos de recursos de supervisión para Monitoring y Logging.

Estos cambios surten efecto cuando usas Stackdriver Kubernetes Monitoring. Por ejemplo, si actualizas un clúster existente, tendrás dos conjuntos de métricas y tipos de recursos supervisados. Las métricas y los tipos anteriores contendrán datos y registros de antes a la actualización. Las métricas y tipos nuevos reciben datos y registros desde el momento de la actualización.

Estos cambios tienen los siguientes efectos en las actividades relacionadas con Kubernetes en Stackdriver Logging y Monitoring:

  • Políticas de alertas. Es posible que tus políticas de alertas actuales no se activen o se activen de manera inesperada, ya que se refieren a métricas o tipos de recursos que no reciben datos nuevos.

  • Métricas basadas en registros. Es posible que tus métricas actuales basadas en registros no encuentren ninguna entrada de registro de GKE que coincida porque buscan entradas de registro nuevas con los tipos de recursos o etiquetas de recursos anteriores.

  • Exportaciones de registros. Tus receptores de exportación actuales pueden dejar de exportar registros de GKE porque los filtros de los receptores ya no coinciden con los tipos de recursos nuevos de las entradas del registro de GKE.

  • Exclusiones de registros. Es posible que tus exclusiones actuales no eliminen los registros de GKE que esperabas porque los filtros de exclusión ya no coinciden con los tipos de recursos nuevos de las entradas del registro de GKE.

  • Gráficos personalizados. Es posible que tus gráficos y paneles personalizados dejen de mostrar datos de GKE nuevos porque se refieren a métricas que ya no reciben datos. Si usas el Explorador de métricas, recuerda elegir los tipos de recursos de GKE nuevos y los nombres de métricas.

  • Datos perdidos. No hay forma de unir las entradas de registro o los datos de supervisión para que puedas ver un flujo de datos ininterrumpido que se extienda antes y después de tu actualización.

Las siguientes secciones describen los cambios con más detalle. Incluyen instrucciones sobre cómo migrar las funciones existentes de supervisión y de registro de Stackdriver a Stackdriver Kubernetes Monitoring.

Métricas de GKE

Los nombres de las métricas de GKE cambiaron. Haz clic en los nombres en la siguiente tabla para obtener una lista de métricas:

Nombres de métricas heredadas Nombres de métricas de Stackdriver Kubernetes Monitoring
container.googleapis.com/* kubernetes.io/*

Migración desde asistencia heredada: Revisa todos tus gráficos personalizados y políticas de alertas. Cambia los nombres de métricas heredadas por los nombres de métricas de Stackdriver Kubernetes Monitoring.

Tipos de recursos de GKE

Los nombres de los tipos de recursos supervisados usados para Kubernetes se enumeran a continuación. Haz clic en los nombres para obtener una descripción detallada. Los cambios de nombre de las etiquetas de tipo de recurso se enumeran después de las instrucciones de migración.

Tipo de recurso heredado Tipo de recurso de Stackdriver Kubernetes Monitoring
Contenedor de G​K​E (gke_container)M
Contenedor de G​K​E (container)L
Contenedor de Kubernetes (k8s_container)L+M
(ninguno) Clúster de Kubernetes (k8s_cluster)L+M
Instancia de VM de G​C​E (gce_instance)L+M Nodo de Kubernetes (k8s_node)L+M
(ninguno) Pod de Kubernetes (k8s_pod)L+M

Notas:
M Usado por Monitoring.
L Usado por Logging.
L+M Usado tanto por Monitoring como por Logging.

Migración desde asistencia heredada (Logging): Examina todos los filtros de registros avanzados y cambia los tipos de recursos y etiquetas anteriores por los tipos nuevos de recursos y etiquetas. Se pueden usar los filtros en los siguientes elementos:

  • Métricas basadas en registros
  • Receptores de exportaciones de registros
  • Exclusiones de registros

Migración desde asistencia heredada (Monitoring): Examina todos tus filtros de supervisión, cambia los tipos de recursos y etiquetas anteriores por los tipos nuevos de recursos y etiquetas. Se pueden usar tus filtros de supervisión en los siguientes elementos:

  • Definiciones de gráficos personalizados
  • Definiciones de grupo
  • Condiciones de política de alertas

Etiquetas de recursos

Las etiquetas en los tipos de recursos supervisados nuevos son ligeramente diferentes de las etiquetas usadas en los tipos anteriores, como se explica en las siguientes secciones.

Del container al k8s_container (Logging)

La siguiente tabla enumera las etiquetas diferentes en los dos tipos de recursos supervisados:

Contenedor de G​K​E
Etiqueta (container)
Contenedor de Kubernetes
Etiqueta (k8s_container)
Notas
project_id project_id Sin cambios
cluster_name cluster_name Sin cambios
namespace_id namespace_name Sin cambios en la mayoría de los casos
instance_id Usa metadata.systemLabels.node_name1
pod_id pod_name
container_name container_name Sin cambios
zone location zone se refiere a la ubicación de la instancia (nodo);
location se refiere a la ubicación del clúster

1 En las entradas de registro, el campo instance_id actual contiene el identificador de instancia numérico. El campo metadata.systemLabels.node_name contiene el identificador de instancia alfanumérico. Ambos se refieren a la misma instancia.

Desde gke_container hasta k8s_container (Monitoring)

La siguiente tabla enumera las etiquetas diferentes en los dos tipos de recursos supervisados:

Contenedor de G​K​E
Etiqueta (gke_container)
Contenedor de Kubernetes
Etiqueta (k8s_container)
Notas
project_id project_id Sin cambios
cluster_name cluster_name Sin cambios
namespace_id namespace_name Sin cambios en la mayoría de los casos
instance_id Usa metadata.systemLabels.node_name1
pod_id pod_name
container_name container_name Sin cambios
zone location zone se refiere a la ubicación de la instancia (nodo);
location se refiere a la ubicación del clúster 2

1 En los datos de métrica, tanto el campo instance_id como el campo metadata.systemLabels.node_name tienen el mismo valor: El identificador de instancia alfanumérico.
2 En un clúster "zonal" de Google Kubernetes Engine, estos valores son los mismos. En un clúster "regional" de Google Kubernetes Engine, los valores pueden ser diferentes.

De gce_instance a k8s_node

La siguiente tabla enumera las etiquetas diferentes en los dos tipos de recursos supervisados:

Instancia de VM de G​C​E
Etiqueta (gce_instance)
Nodo de Kubernetes
Etiqueta (k8s_node)
Notas
project_id project_id Sin cambios
(ninguno) cluster_name
instance_id node_name
zone location zone se refiere a la ubicación de la instancia (nodo);
location se refiere a la ubicación del clúster 2

1 El campo actual de instance_id puede contener el identificador de instancia numérico o puede contener el identificador alfanumérico. El campo metadata.systemLabels.node_name siempre contiene el identificador de instancia alfanumérico. Ambos se refieren a la misma instancia.
2 En un clúster "zonal" de Google Kubernetes Engine, estos valores son los mismos. En un clúster "regional" de Google Kubernetes Engine, los valores pueden ser diferentes.

Registro de GKE

Cuando actualizas a Stackdriver Kubernetes Monitoring, los siguientes cambios relacionados con los registros entrarán en vigor:

  • Los cambios de tipo de recurso descritos anteriormente significan que tus entradas de registro ahora aparecen en el visor de registros bajo estos encabezados de recursos:

  • Las entradas de registro en k8s_container tienen un ID de registro de stdout o stderr, en lugar del nombre del clúster de contenedor. El nombre del clúster está en el campo resource.labels.

  • Las entradas de registro pueden tener diferentes contenidos en su campo con permisos de administrador (nivel superior) labels. Para obtener más información, verifica el campo resource.labels, este debe ser coherente con la asistencia heredada de Google Analytics.

Migración desde asistencia heredada: Si tienes métricas basadas en registros, receptores de exportaciones de registros), o exclusiones de registros cuyos filtros usan tipos de recursos supervisados por Kubernetes, entonces realiza lo siguiente:

  • Actualiza a los tipos de recursos nuevos.
  • Cambia las referencias al campo de entrada de registro de labels a resource.labels.
  • Cambia los valores de resource.label de acuerdo con la sección anterior de Etiquetas de recursos.

Próximos pasos

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Stackdriver Monitoring
¿Necesitas ayuda? Visita nuestra página de asistencia.