Establecer la observabilidad de las flotas

El registro y la supervisión pueden ayudarle a solucionar problemas en IBM Cloud® Code Engine y proporcionarle información sobre el rendimiento de su carga de trabajo. La configuración del registro y la supervisión de las flotas se realiza a nivel de proyecto y es diferente de otras funciones de Code Engine.

El registro y la supervisión son opcionales y pueden configurarse en cualquier momento tras la creación de una flota.

Configuración del registro de datos para flotas

El registro de las flotas se configura a nivel de proyecto. Después de realizar estos pasos de configuración para un proyecto, el registro está disponible para todas las flotas de ese proyecto.

1. Asegúrese de que dispone de una instancia del servicio Cloud Logs

Debe tener una instancia del servicio Cloud Logs que se dirija a la región del proyecto Code Engine en la que se ejecutan sus flotas. Para comprobar las instancias de servicio de Cloud Logs existentes, vaya a la página Enrutamiento de registros en la interfaz de usuario e identifique la instancia que se dirige a la región correspondiente. Si la región no tiene una instancia de registro específica, siga las instrucciones de la interfaz de usuario para establecer una.

2. Establecer los permisos para la instancia de Cloud Logs

Asegúrese de tener un ID de servicio y una clave de API que asignen acceso a la instancia de Cloud Logs y establezca los permisos necesarios.

  1. Cree un ID de servicio. A continuación, asigne al ID de servicio una política de acceso dirigida a la instancia de Cloud Logs de su cuenta. Asigne a esta política de acceso el nivel de acceso al servicio Remitente.
  2. Cree una clave API para el ID de servicio. Guarde la clave API en un lugar seguro para poder consultarla más adelante.

3. Obtener el punto final de entrada privado para la instancia de Cloud Logs

Obtenga el punto final de entrada privado para la instancia de Cloud Logs.

  1. Vaya a la página Instancias de registro en la interfaz de usuario y haga clic en la instancia correspondiente.
  2. Haz clic en « Endpoints ».
  3. Encuentre el punto final privado de Ingress. Guarde este valor en un lugar seguro para poder consultarlo más adelante.

4. Cree una pasarela de punto final privada virtual que se conecte a la instancia de registro

Cree una pasarela de punto final privada virtual que se conecte a la instancia de registro. Esta pasarela VPE debe crearse en la VPC en la que se ejecutan sus flotas.

  1. Vaya a la página de pasarelas VPE en la consola.
  2. Pulse Crear.
  3. Seleccione la ubicación y la región en la que se encuentra su instancia de Cloud Logs.
  4. Seleccione la VPC en la que operan sus flotas.
  5. Conecte el servicio a su instancia de Cloud Logs.
    1. En la sección Solicitar conexión a un servicio, seleccione la opción IBM Cloud Service.
    2. En Ofertas de servicios en la nube, seleccione Registros en la nube.
    3. En Regiones de servicios en la nube, seleccione la región en la que se encuentra su instancia de Cloud Logs.
    4. En la tabla, seleccione la instancia de Cloud Logs correspondiente para conectarse al VPE.
  6. Pulse Crear.

5. Crear direcciones IP reservadas en el gateway VPE

Para cada zona del VPE, añada una dirección IP reservada a una subred.

  1. Vaya a la página de pasarelas VPE en la consola.
  2. Haz clic en el VPE que has creado en el paso anterior.
  3. Haz clic en « Gestionar recursos adjuntos ».
  4. Haz clic en «Reservar» o «Asignar IP ».
  5. Siga las instrucciones para reservar una dirección IP para una subred en una de las zonas VPE.
  6. Repita este proceso para una subred en cada zona VPE.

6. Añade los valores de registro al secreto por defecto de las flotas

Añade los valores de registro necesarios al secreto por defecto de las flotas.

  1. En la consola, vaya a la página de proyectos Code Engine y seleccione el proyecto en el que se ejecutan sus flotas.
  2. Haz clic en «Secrets» y «configmaps ».
  3. Haga clic en el secreto codeengine-fleet-defaults.
    1. Si no se ha creado antes: haga clic en Crear.
    2. Seleccione Secreto genérico y haga clic en Siguiente.
    3. Nombra el secreto codeengine-fleet-defaults. Debe utilizar este nombre y formato exactos.
  4. Añada los pares clave-valor que figuran en la tabla siguiente. Tenga en cuenta que logging_sender_api_key y logging_ingress_endpoint se guardaron en pasos anteriores.
Registro de pares clave-valor para el secreto por defecto de las flotas.
Clave Valor
logging_ingress_endpoint El punto de entrada privado para la instancia de Cloud Logs. Este valor se guarda en un paso anterior.
logging_sender_api_key La clave de API para el ID de servicio que tiene como objetivo la instancia de Cloud Logs. Este valor se guarda en un paso anterior.
logging_ingress_port El puerto utilizado para conectarse a la instancia de Cloud Logs. Para VPEs privados, especifique 443.
logging_level_worker El nivel de detalle que desea incluir en los registros de sus trabajadores. Los niveles aceptados son: DEBUG, INFO, WARN, y ERROR. Nivel por defecto: WARN.
logging_level_agent El nivel de detalle que desea incluir en los registros de su agente de flota. Los niveles aceptados son: DEBUG, INFO, WARN, y ERROR. Nivel por defecto: WARN.

7. Consulta los registros de tu flota

Ahora que el registro está configurado para las flotas en su proyecto Code Engine, puede ver los registros de su flota. Consulte Visualización de registros y datos de seguimiento de flotas para conocer los pasos a seguir.

Configuración del seguimiento de flotas

El seguimiento de las flotas se establece a nivel de proyecto. Después de realizar estos pasos de configuración para un proyecto, la monitorización estará disponible para todas las flotas de ese proyecto.

1. Asegúrese de que dispone de una instancia de Clouds Monitoring

Debe tener una instancia de Cloud Monitoring en la misma región del proyecto Code Engine a la que pertenece su flota. Para comprobar las instancias de servicio Cloud Monitoring existentes, vaya a la página Instancias de supervisión de la interfaz de usuario e identifique una instancia en la región correspondiente. Si no dispone de una instancia adecuada, siga las instrucciones de la interfaz de usuario para crear una.

2. Obtener la clave del agente de vigilancia

Busque la clave de agente para la instancia de monitorización.

  1. Vaya a la página de instancias de supervisión en la interfaz de usuario y haga clic en la instancia correspondiente. En la página de detalles de la instancia, haga clic en Acciones > Gestionar clave y, a continuación, haga clic en la opción para ver todas las claves en el panel de control.
  2. Haga clic en la clave del agente, que puede tener un formato similar a ab1c2345-****-678d9efgh012. A continuación, haga clic en la opción para copiar la clave completa del agente.
  3. Guarde la clave del agente en un lugar seguro al que pueda acceder más tarde.

3. Cree una pasarela de punto final privada virtual que se conecte a la instancia de supervisión

Cree una puerta de enlace virtual privada que se conecte a la instancia de monitorización. Esta pasarela VPE debe crearse en la VPC en la que se ejecutan sus flotas.

  1. Vaya a la página de pasarelas VPE en la consola.
  2. Pulse Crear.
  3. Selecciona la ubicación y la región en las que se encuentra tu instancia de Cloud Monitoring.
  4. Seleccione la VPC en la que operan sus flotas.
  5. Conecta el servicio a tu instancia de Cloud Monitoring.
    1. En la sección Solicitar conexión a un servicio, seleccione la opción IBM Cloud Service.
    2. En Ofertas de servicios en la nube, seleccione Cloud Monitoring.
    3. En Regiones de servicios en la nube, seleccione la región en la que se encuentra su instancia de Cloud Monitoring.
    4. En la tabla, seleccione la instancia Cloud Monitoring correspondiente para conectarse al VPE.
  6. Pulse Crear.

4. Crear direcciones IP reservadas en el gateway VPE

Para cada zona del VPE, añada una dirección IP reservada a una subred.

  1. Vaya a la página de pasarelas VPE en la consola.
  2. Haz clic en el VPE que has creado en el paso anterior.
  3. Haz clic en « Gestionar recursos adjuntos ».
  4. Haz clic en «Reservar» o «Asignar IP ».
  5. Siga las instrucciones para reservar una dirección IP para una subred en una de las zonas VPE.
  6. Repita este proceso para una subred en cada zona VPE.

5. Añadir valores de supervisión al secreto por defecto de las flotas

  1. En la consola, vaya a la página de proyectos Code Engine y seleccione el proyecto en el que se ejecutan sus flotas.
  2. Haz clic en «Secrets» y «configmaps ».
  3. Haga clic en el secreto codeengine-fleet-defaults.
    1. Si no se ha creado antes: haga clic en Crear.
    2. Seleccione Secreto genérico y haga clic en Siguiente.
    3. Nombra el secreto codeengine-fleet-defaults. Debe utilizar este nombre y formato exactos.
  4. Añada los pares clave-valor que figuran en la tabla siguiente. Tenga en cuenta que monitoring_ingestion_key se guardó en un paso anterior.
Registro de pares clave-valor para el secreto por defecto de las flotas.
Clave Valor
monitoring_ingestion_region La región en la que se encuentra la instancia Cloud Monitoring. Ejemplo: au-syd.
monitoring_ingestion_key La clave del agente de vigilancia. Este valor se encontró en un paso anterior.

6. Visualice los datos de su flota en el panel de control

Ahora que la monitorización está configurada para flotas en su proyecto Code Engine, puede ver los datos de monitorización de su flota. Consulte Visualización de registros y datos de seguimiento de flotas para conocer los pasos a seguir.