Solucionar problemas con un tema de importación de Amazon Managed Streaming para Apache Kafka

En este documento se ofrecen algunos consejos para solucionar problemas habituales con los temas de importación de Amazon Managed Streaming para Apache Kafka (Amazon MSK).

Después de configurar el tema de importación y empezar a ingerir mensajes, puedes consultar las métricas de Cloud Monitoring pertinentes para ver si se están ingiriendo datos. Sigue estos pasos:

1. En la consola, ve a la página Temas.

   Ir a Temas

2. Haz clic en el tema de importación de Amazon MSK que quieras solucionar.

3. En la página de detalles del tema, haga clic en la pestaña Métricas.

4. Consulta el gráfico de la métrica Número de bytes de ingestión.

5. Si no se ingieren datos, en la página de detalles del tema, compruebe si hay algún error en el campo Estado del tema.

6. También puede consultar la métrica Estado de la fuente de datos de ingestión. Para ello, en la página de detalles del tema, haga clic en la pestaña Métricas.

7. A continuación se indica una lista de errores que pueden aparecer:

   Código de error	Descripción	Solucionar
   MSK_PERMISSION_DENIED	Error al consumir datos de Amazon MSK debido a problemas de permisos.	Verifica que el ARN del rol de AWS sea correcto y comprueba que el rol de AWS tenga los permisos de lectura necesarios. Para obtener más información, consulta Crear una política en AWS.
   		Comprueba que exista una cuenta de servicio y que esté configurada correctamente, tal como se describe en el procedimiento Crear un rol en AWS con una política de confianza personalizada. Para obtener más información sobre cómo crear una cuenta de servicio, consulta el artículo Crear una cuenta de servicio Google Cloud.
   		Verifica que la cuenta de servicio de Pub/Sub tenga el permiso iam.serviceAccounts.getOpenIdToken. Para obtener más información, consulta el artículo Añadir el rol Creador de tokens de cuenta de servicio a la cuenta de servicio de Pub/Sub.
   		Comprueba que has añadido el rol de usuario de cuenta de servicio a la cuenta de servicio. Para obtener más información, consulta Añadir el rol Usuario de cuenta de servicio a la cuenta de servicio.
   PUBLISH_PERMISSION_DENIED	Error al publicar en el tema de Pub/Sub debido a problemas con los permisos.	Concede a la cuenta de servicio de Pub/Sub los permisos de publicación necesarios. Para obtener más información, consulta Añadir el rol de editor de Pub/Sub a la cuenta de servicio de Pub/Sub.
   CLUSTER_NOT_FOUND	No se ha encontrado el clúster proporcionado.	Verifica que el ARN del clúster sea correcto. Asegúrate de que el clúster exista y sea accesible.
   Cluster is not public	No se puede acceder al clúster proporcionado	No se admiten clústeres no públicos detrás de VPCs. Debes usar un clúster público.
   TOPIC_NOT_FOUND	No se ha encontrado el tema de Kafka proporcionado.	Verifica que el nombre del tema sea correcto. Asegúrate de que el tema exista en el clúster especificado.

Si no se ha producido ningún error hasta este punto, consulta las prácticas recomendadas en Mantener una cuenta de editor en buen estado.

También puedes habilitar los registros de la plataforma de un tema de importación. Estos registros le ayudan a solucionar problemas cuando tiene problemas para ingerir objetos en temas de importación de Pub/Sub.