Creación de un log

• Consola
• CLI
• API

• Los grupos de logs son contenedores lógicos para organizar logs. Los logs siempre deben estar dentro de los grupos de logs. Debe crear un grupo de logs antes de crear un log.

  Para obtener más información sobre los logs y los permisos necesarios para trabajar con ellos, consulte Gestión de grupos de logs.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Registro, haga clic en Logs.
  2. En Ámbito de lista, seleccione un compartimento en el que tenga permiso para trabajar.
  3. Haga clic en Crear log personalizado.
  4. En la página Crear log personalizado, introduzca un nombre para el log personalizado. Evite introducir información confidencial.
  5. En compartimento, seleccione el compartimento en el que desea crear el inicio de sesión.
  6. En Grupo de logs, seleccione un grupo de logs en el que colocar el log personalizado.
  7. También puede hacer clic en Mostrar opciones adicionales y proporcionar los siguientes valores:
     • En Retención de log, seleccione cuánto tiempo retener el log en incrementos de 30 días, hasta un máximo de 180 días.
       Nota
       
       

       Si cambia el período de retención de seis meses a un mes, ya no se podrá acceder a todos los logs de más de un mes de antigüedad. Por ejemplo, si cambia de un mes a seis meses, los logs no estarán disponibles después de un mes y los logs de seis meses de antigüedad no estarán disponibles.

       Además, la fecha y hora futuras en que un registro deje de estar disponible se basa en la fecha y hora exactas en que creó el registro. Por ejemplo, si creó un log el 21 de julio a las 15:05 UTC con un período de retención de tres meses, el 19 de octubre a las 15:05 ya no se podrá buscar en el log.

     • En Agregar etiquetas, introduzca un espacio de nombres de etiqueta (para una etiqueta definida), una clave y un valor para agregar una o más etiquetas al log.
  8. Haga clic en Crear log personalizado.
     En la página Crear configuración de agente, puede crear una nueva configuración para definir los parámetros de los datos de log asociados (valor por defecto) o agregarla más tarde. La configuración de agente define las instancias a las que se aplica la configuración (Grupos de hosts), los archivos log que se obtienen y el analizador (si existe) (Configurar entradas de log).

     • Si selecciona Crear nueva configuración, vaya al siguiente paso.
     • Si selecciona Agregar configuración más tarde, vaya al paso 16.
  9. Introduzca un nombre y una descripción para la configuración. Evite introducir información confidencial.
  10. Seleccione el compartimento en el que desea crear la configuración.
  11. En Grupos de hosts, donde puede definir las máquinas virtuales que se aplican a esta configuración, seleccione una de las siguientes opciones de la lista Tipo de grupo:
      • Grupo dinámico: Grupo dinámico hace referencia a un grupo de instancias que puede crear en la función IAM de la consola. Para obtener más información, consulte Acerca de los grupos dinámicos. Seleccione un grupo dinámico en la lista Grupo.
      • Grupo de usuarios: Grupo de usuarios hace referencia a la función Grupos de IAM de la consola. Para obtener más información, consulte Gestión de Grupos. Seleccione un grupo de usuarios de la lista Grupo.
  12. Para agregar más grupos, haga clic en + Otro grupo de hosts.

      Puede agregar una combinación de tipos de grupo para la configuración del agente.

      Nota
      
      Se permite un máximo de cinco grupos por configuración, y un host puede estar en un máximo de cinco grupos diferentes.
  13. En Configuración de agente, defina el formato de los logs (lo que desea observar) en Configurar entradas de log. Seleccione una de las opciones de la lista Tipo de entrada:
      • En Log de evento de Windows, introduzca un nombre de entrada y seleccione uno o más canales de evento.
      • Para Ruta de acceso de log, introduzca un nombre de entrada y una o más rutas de acceso de archivo. Por ejemplo, /<ruta_de_log>/<nombre_de_log>.

      Puede especificar varias rutas de acceso de archivos log, separadas por una coma (,). Para obtener más información, consulte https://docs.fluentd.org/input/tail#path.

      <source>
      @type tail
      tag 757261.oc_oslogs_linux
      path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
       var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
      pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
      path_key tailed_path
      </source>

      Ejemplo de configuración:

      {{path C:\Program Files (x86)\<application>\<directory>*, 
       C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

      Haga clic en + Otra entrada de log para agregar más entradas de log personalizadas.

  14. Haga clic en Opciones avanzadas de analizador y, en el panel Opciones avanzadas de analizador, seleccione un analizador para especificar cómo analizar el log. Algunos analizadores requieren más entradas y tienen más opciones, según el tipo elegido.

      Por ejemplo, para JSON, debe seleccionar un valor de Tipo de tiempo en la lista, mientras que, opcionalmente, puede especificar la hora de evento y la configuración del campo nulo. Para REGEXP, puede especificar la expresión regular para los logs coincidentes junto con el formato de hora. Para obtener más información, consulte entrada y análisis de log.

      Importante
      
      El tipo de analizador NONE es necesario, incluso si no desea especificar un tipo de analizador concreto.
  15. Después de configurar las entradas y el analizador de log, puede especificar opcionalmente los valores de etiqueta.
  16. Haga clic en Crear configuración de agente.

      Se crea el objeto de log personalizado, junto con la configuración de su agente asociado (si se especifica), que obtiene datos de instancias y los transfiere al objeto de log personalizado.

• Utilice el comando oci logging log create y los parámetros necesarios para crear un registro en un grupo de logs:

  oci logging log create --display-name display_name --log-group-id log_group_ocid --log-type log_type [OPTIONS]

  Para obtener una lista completa de los parámetros y las opciones de variables para los comandos de la CLI, consulte Referencia de la línea de comandos.

• Ejecute la operación CreateLog para crear un registro en un grupo de logs.