Documentación de Oracle Cloud Infrastructure

Visualización de Logs de Aplicación en Nodos Gestionados y Nodos Autogestionados

Descubra cómo ver los logs de aplicaciones que se ejecutan en nodos gestionados y nodos autogestionados en un cluster de Kubernetes que ha creado mediante Container Engine for Kubernetes (OKE).

Una vez creado un cluster mediante Container Engine for Kubernetes, puede utilizar Oracle Cloud Infrastructure Logging para ver y buscar los logs de aplicaciones que se ejecutan en instancias informáticas que alojan nodos gestionados y nodos autogestionados en el cluster.

Antes de poder recopilar y analizar los logs de aplicación mediante Oracle Cloud Infrastructure Logging:

  • Ya debería haber:
    • Supervisión activada para instancias informáticas que alojan nodos gestionados y nodos autogestionados (consulte Activación de la supervisión para instancias informáticas).
    • Instalado el software de Oracle Cloud Agent en instancias informáticas que alojan nodos gestionados y nodos autogestionados. El agente permite especificar qué logs se van a recopilar y cómo analizarlos. El agente se instala por defecto en instancias informáticas de nodo gestionado. Para confirmar que el agente ya está instalado, consulte Verificación de la instalación del agente.
  • Ya debería haber:
    • Creado un grupo dinámico con una regla que incluye las instancias informáticas que alojan nodos gestionados y nodos autogestionados como hosts de destino (consulte Acerca de los grupos dinámicos y Selección de hosts de destino con grupos dinámicos). Por ejemplo:
      instance.compartment.id = 'ocid1.tenancy.oc1..<unique-id>'
    • Se ha creado una política para el grupo dinámico con una sentencia de política a fin de permitir que los hosts de destino del grupo dinámico transfieran logs a Oracle Cloud Infrastructure Logging (consulte Selección de hosts de destino con grupos dinámicos). Por ejemplo:
      allow dynamic-group <dynamic-group-name> to use log-content in tenancy

      Tenga en cuenta que si un grupo dinámico no está en el dominio de identidad por defecto, agregue un prefijo al nombre de grupo dinámico con el nombre de dominio de identidad, con el formato dynamic-group '<identity-domain-name>'/'<dynamic-group-name>'. También puede especificar el grupo dinámico mediante su OCID, con el formato dynamic-group id <dynamic-group-ocid>.

Una vez completados los requisitos previos anteriores, puede definir logs personalizados y configuraciones de agente asociadas para ver logs de aplicación en instancias informáticas que alojan nodos gestionados y nodos autogestionados. Tenga en cuenta que los logs de aplicación se deben mostrar en la ruta de acceso del archivo que especifique al crear una configuración de agente (normalmente, pero no necesariamente, /var/logs/containers). Para obtener más información sobre los logs personalizados y las configuraciones de agente, consulte Logs personalizados.

Tenga en cuenta que, además de ver los logs de aplicación en instancias informáticas que alojan nodos gestionados y nodos autogestionados, también puede:

Uso de la consola

Para definir un nuevo objeto de log personalizado y una configuración de agente asociada que le permita ver y buscar los logs de las aplicaciones que se ejecutan en instancias informáticas que alojan nodos gestionados y nodos autogestionados en un cluster:

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Registro, haga clic en Logs.
  2. Seleccione un compartimento en el que tenga permiso para trabajar.
  3. Haga clic en Crear log personalizado para crear un nuevo log personalizado.

  4. En la página Crear log personalizado, especifique:

    • Nombre de log personalizado: nombre que elija para el nuevo log personalizado. Evite introducir información confidencial.
    • Compartimento: compartimento en el que se va a crear el nuevo log personalizado.
    • Grupo de logs: grupo de logs en el que se va a colocar el log personalizado. También puede hacer clic en Crear nuevo grupo para crear un nuevo grupo de logs (consulte Logs y grupos de logs).
  5. También puede hacer clic en Mostrar opciones adicionales y especificar:
    • Retención del log: tiempo (en meses) durante el que retener el log personalizado. Seleccione una de las opciones predefinidas o seleccione Hora personalizada y especifique un número de meses de su elección (hasta 60).
    • Opciones de etiquetado: si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar las etiquetas más tarde.

  6. Haga clic en Crear log personalizado.

    Se crea un nuevo log personalizado y se muestra la página Crear configuración de agente.

    Para su comodidad, estas instrucciones describen cómo crear una nueva configuración de agente asociada con el nuevo log personalizado (aunque puede crear una nueva configuración de agente más adelante, si lo prefiere).

  7. En la página Crear configuración de agente, seleccione Crear nueva configuración y especifique:

    • Nombre de configuración: nombre que elija para la nueva configuración de agente. Evite introducir información confidencial.
    • Descripción: descripción de la nueva configuración de agente.
    • Compartimento: compartimento en el que se va a crear la nueva configuración de agente.
  8. En el panel Grupos de hosts de la página Crear configuración de agente, especifique:
    • Tipo de grupo: seleccione Grupo dinámico.
    • Grupo: grupo dinámico existente que incluye nodos gestionados en los pools de nodos gestionados del cluster como hosts de destino. El grupo dinámico que seleccione debe tener permiso para acceder al compartimento especificado para la configuración de agente y también debe permitir que los hosts de destino transfieran logs a Oracle Cloud Infrastructure Logging.

  9. En el panel Configuración de agente de la página Crear configuración de agente, especifique:

    • Configurar entradas de log: una o más ubicaciones desde las que obtener logs de aplicación como entradas al log personalizado, de la siguiente manera:
      • Tipo de entrada: seleccione Ruta de log.
      • Nombre de entrada: nombre que elija para la nueva entrada de log.
      • Rutas de acceso de archivo: ruta de acceso a logs de aplicación en las instancias informáticas que alojan nodos gestionados y nodos autogestionados. Por ejemplo, normalmente (pero no necesariamente) /var/logs/containers/*
    • Seleccionar destino de registro: las opciones se rellenan previamente con los detalles de registro personalizados especificados anteriormente.
  10. También puede hacer clic en Mostrar opciones adicionales y especificar:
    • Opciones de etiquetado: si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar las etiquetas más tarde.
  11. Haga clic en Crear configuración de agente para crear la configuración de agente asociada al log personalizado.

Para ver y buscar el contenido de un log personalizado creado para una aplicación que se ejecuta en instancias informáticas que alojan nodos gestionados y nodos autogestionados en un cluster:

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Registro, haga clic en Logs.
  2. Haga clic en el nombre del log personalizado que desea ver. Puede ordenar entradas de log por antigüedad y filtrarlas por tiempo.
  3. (Opcional) Haga clic en Acciones y seleccione Explorar con búsqueda de log para abrir la página Buscar del registro central. Puede aplicar filtros y explorar y visualizar los datos de log de diferentes maneras (consulte Visualización de logs personalizados en una instancia de Compute).