Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Gestor de registros
El componente gestor de registros (aws.greengrass.LogManager
) carga los registros de los dispositivos AWS IoT Greengrass principales a Amazon CloudWatch Logs. Puede cargar registros desde el núcleo de Greengrass, otros componentes de Greengrass y otras aplicaciones y servicios que no son componentes de Greengrass. Para obtener más información sobre cómo supervisar los CloudWatch registros en Logs y en el sistema de archivos local, consulte. Supervisar AWS IoT Greengrass registros
Cuando se utiliza el componente gestor de registros para escribir en los CloudWatch registros, se tienen en cuenta las siguientes consideraciones:
-
Retrasos de registro
Le recomendamos que actualice a la versión 2.3.0 del administrador de registros, ya que reduce las demoras en el registro de los archivos de registro activos y rotados. Cuando actualice a log manager 2.3.0, le recomendamos que también actualice a Greengrass nucleus 2.9.1.
La versión 2.2.8 (y anteriores) del componente gestor de registros procesa y carga los registros únicamente a partir de archivos de registro rotados. De forma predeterminada, el software AWS IoT Greengrass Core rota los archivos de registro cada hora o después de que ocupen 1024 KB. Como resultado, el componente del administrador de registros carga los registros solo después de que el software AWS IoT Greengrass Core o un componente de Greengrass hayan escrito registros con un valor superior a 1024 KB. Puede configurar un límite de tamaño de archivo de registro inferior para que los archivos de registro roten con más frecuencia. Esto hace que el componente del administrador de registros cargue registros en CloudWatch Logs con más frecuencia.
La versión 2.3.0 (y posteriores) del componente administrador de registros procesa y carga todos los registros. Al escribir un registro nuevo, la versión 2.3.0 (y posteriores) del administrador de registros procesa y carga directamente el archivo de registro activo en lugar de esperar a que se rote. Esto significa que puede ver el nuevo registro en 5 minutos o menos.
El componente del administrador de registros carga nuevos registros periódicamente. De forma predeterminada, el componente del administrador de registros carga nuevos registros cada 5 minutos. Puede configurar un intervalo de carga más bajo, de modo que el componente del administrador de registros cargue los registros en los CloudWatch registros con más frecuencia configurando el. periodicUploadIntervalSec
Para obtener más información sobre cómo configurar este intervalo periódico, consulte Configuración.
Los registros se pueden cargar prácticamente en tiempo real desde el mismo sistema de archivos de Greengrass. Si necesita observar los registros en tiempo real, considere la posibilidad de utilizar los registros del sistema de archivos.
Si utiliza distintos sistemas de archivos para escribir los registros, el administrador de registros vuelve al comportamiento de las versiones 2.2.8 y anteriores de los componentes del administrador de registros. Para obtener información sobre cómo acceder a los registros del sistema de archivos, consulte Acceder a los registros del sistema de archivos.
-
Inclinación del reloj
El componente de gestión de registros utiliza el proceso de firma estándar de la versión 4 de Signature para crear solicitudes de API a CloudWatch los registros. Si la hora del sistema en un dispositivo principal está desincronizada durante más de 15 minutos, CloudWatch Logs rechaza las solicitudes. Para obtener más información, consulte Proceso de firma Signature Version 4 en la Referencia general de AWS.
Para obtener información sobre los grupos de registros y los flujos de registros a los que este componente carga los registros, consulteUso.
Versiones
Este componente tiene las siguientes versiones:
Tipo
Este componente es un componente de complemento ()aws.greengrass.plugin
. El núcleo de Greengrass ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.
Este componente utiliza el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte Supervisar AWS IoT Greengrass registros.
Para obtener más información, consulte Tipos de componentes.
Sistema operativo
Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:
Requisitos
Este componente tiene los siguientes requisitos:
-
El rol de dispositivo Greengrass debe permitir las logs:DescribeLogStreams
accioneslogs:CreateLogGroup
,, y logs:CreateLogStream
logs:PutLogEvents
, como se muestra en el siguiente ejemplo de política de IAM.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Effect": "Allow",
"Resource": "arn:aws:logs:*:*:*"
}
]
}
La función de dispositivo Greengrass que se crea al instalar el software AWS IoT Greengrass Core incluye los permisos de esta política de ejemplo de forma predeterminada.
Para obtener más información, consulte Uso de políticas basadas en la identidad (políticas de IAM) para CloudWatch los registros en la Guía del usuario de Amazon CloudWatch Logs.
-
Se admite la ejecución del componente de administrador de registros en una VPC. Para implementar este componente en una VPC, se requiere lo siguiente.
Puntos finales y puertos
Este componente debe poder realizar solicitudes salientes a los siguientes puntos finales y puertos, además de a los puntos finales y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte Permitir el tráfico del dispositivo a través de un proxy o firewall.
punto de enlace |
Puerto |
Obligatoria |
Descripción |
logs.region .amazonaws.com
|
443 |
No |
Es obligatorio si escribes registros en Logs. CloudWatch
|
Dependencias
Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementarlo correctamente. En esta sección se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola. AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.
- 2.3.7
-
La siguiente tabla muestra las dependencias de la versión 2.3.7 de este componente.
- 2.3.5 and 2.3.6
-
La siguiente tabla muestra las dependencias de las versiones 2.3.5 y 2.3.6 de este componente.
- 2.3.3 – 2.3.4
-
La siguiente tabla muestra las dependencias de las versiones 2.3.3 a 2.3.4 de este componente.
- 2.2.8 – 2.3.2
-
La siguiente tabla muestra las dependencias de las versiones 2.2.8 a 2.3.2 de este componente.
- 2.2.7
-
La siguiente tabla muestra las dependencias de la versión 2.2.7 de este componente.
- 2.2.6
-
La siguiente tabla muestra las dependencias de la versión 2.2.6 de este componente.
- 2.2.5
-
La siguiente tabla muestra las dependencias de la versión 2.2.5 de este componente.
- 2.2.1 - 2.2.4
-
La siguiente tabla muestra las dependencias de las versiones 2.2.1 a 2.2.4 de este componente.
- 2.1.3 and 2.2.0
-
La siguiente tabla muestra las dependencias de las versiones 2.1.3 y 2.2.0 de este componente.
- 2.1.2
-
La siguiente tabla muestra las dependencias de la versión 2.1.2 de este componente.
- 2.1.1
-
La siguiente tabla muestra las dependencias de la versión 2.1.1 de este componente.
- 2.1.0
-
La siguiente tabla muestra las dependencias de la versión 2.1.0 de este componente.
- 2.0.x
-
La siguiente tabla muestra las dependencias de la versión 2.0.x de este componente.
Para obtener más información sobre las dependencias de los componentes, consulta la referencia de recetas de componentes.
Configuración
Este componente proporciona los siguientes parámetros de configuración que puede personalizar al implementar el componente.
- v2.3.6 – v2.3.7
-
logsUploaderConfiguration
-
(Opcional) La configuración de los registros que carga el componente del administrador de registros. Este objeto contiene la siguiente información:
-
systemLogsConfiguration
-
(Opcional) La configuración de los registros del sistema del software AWS IoT Greengrass principal, que incluyen los registros del núcleo y los componentes del complemento de Greengrass. Especifique esta configuración para permitir que el componente gestor de registros gestione los registros del sistema. Este objeto contiene la siguiente información:
uploadToCloudWatch
-
(Opcional) Puede cargar los registros del sistema en CloudWatch Logs.
Valor predeterminado: false
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo se aplica solo si configura el componente núcleo de Greengrass para generar registros en formato JSON. Para habilitar los registros en formato JSON, especifique JSON
el parámetro de formato de registro (logging.format
).
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de los archivos de registro del sistema Greengrass, en la unidad en la que especifique. diskSpaceLimitUnit
Cuando el tamaño total de los archivos de registro del sistema Greengrass supera este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro del sistema Greengrass más antiguos.
Este parámetro equivale al parámetro de límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño máximo total del registro del sistema Greengrass.
diskSpaceLimitUnit
-
(Opcional) La unidad para. diskSpaceLimit
Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
-
componentLogsConfigurationMap
-
(Opcional) Un mapa de las configuraciones de registro de los componentes del dispositivo principal. Cada componentName
objeto de este mapa define la configuración de registro del componente o la aplicación. El componente del administrador de registros carga estos registros de componentes en CloudWatch Logs.
Si está actualizando desde una versión del administrador de registros anterior a la v2.2.0, puede seguir utilizando la lista en su lugar. componentLogsConfiguration
componentLogsConfigurationMap
Sin embargo, le recomendamos encarecidamente que utilice el formato de mapa para poder utilizar las actualizaciones de combinación y restablecimiento para modificar las configuraciones de componentes específicos. Para obtener información sobre el componentLogsConfiguration
parámetro, consulte los parámetros de configuración de la versión 2.1.x de este componente.
componentName
-
La configuración de registro del componentName
componente o la aplicación de esta configuración de registro. Puede especificar el nombre de un componente de Greengrass u otro valor para identificar este grupo de registros.
Cada objeto contiene la siguiente información:
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo solo se aplica si los registros de este componente utilizan un formato JSON específico, que se encuentra en el repositorio del módulo de AWS IoT Greengrass registro GitHub.
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de todos los archivos de registro de este componente, en la unidad en la que especifiquediskSpaceLimitUnit
. Cuando el tamaño total de los archivos de registro de este componente supere este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro más antiguos de este componente.
Este parámetro está relacionado con el parámetro límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño de registro total máximo para este componente.
diskSpaceLimitUnit
-
(Opcional) La unidad deldiskSpaceLimit
. Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
logFileDirectoryPath
-
(Opcional) La ruta a la carpeta que contiene los archivos de registro de este componente.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Valor predeterminado: /greengrass/v2
/logs
.
logFileRegex
-
(Opcional) Expresión regular que especifica el formato de nombre del archivo de registro que utiliza el componente o la aplicación. El componente gestor de registros utiliza esta expresión regular para identificar los archivos de registro de la carpeta situada enlogFileDirectoryPath
.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Si su componente o aplicación rota los archivos de registro, especifique una expresión regular que coincida con los nombres de los archivos de registro rotados. Por ejemplo, puede especificar hello_world\\\\w*.log
cargar los registros de una aplicación de Hello World. El \\\\w*
patrón coincide con cero o más caracteres de palabra, lo que incluye caracteres alfanuméricos y guiones bajos. Esta expresión regular hace coincidir los archivos de registro con y sin marcas de tiempo en su nombre. En este ejemplo, el administrador de registros carga los siguientes archivos de registro:
Predeterminado:componentName
\\\\w*.log
, donde componentName
es el nombre del componente de esta configuración de registro.
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
multiLineStartPattern
-
(Opcional) Expresión regular que identifica cuándo un mensaje de registro de una línea nueva es un mensaje de registro nuevo. Si la expresión regular no coincide con la nueva línea, el componente del administrador de registros anexa la nueva línea al mensaje de registro de la línea anterior.
De forma predeterminada, el componente del administrador de registros comprueba si la línea comienza con un carácter de espacio en blanco, como una pestaña o un espacio. Si no es así, el administrador de registros trata esa línea como un nuevo mensaje de registro. De lo contrario, añade esa línea al mensaje de registro actual. Este comportamiento garantiza que el componente del administrador de registros no divida los mensajes que ocupan varias líneas, como los seguimientos de pila.
-
periodicUploadIntervalSec
-
(Opcional) El período en segundos durante el que el componente del administrador de registros comprueba si hay nuevos archivos de registro para cargar.
Predeterminado: 300
(5 minutos)
Mínimo: 0.000001
(1 microsegundo)
deprecatedVersionSupport
-
Indica si el administrador de registros debe utilizar las mejoras de velocidad de registro introducidas en la versión 2.3.5 del administrador de registros. Establezca el valor en false
para utilizar las mejoras.
Si establece este valor false
al actualizar desde la versión 2.3.1 del administrador de registros o una versión anterior, es posible que se carguen entradas de registro duplicadas.
El valor predeterminado es true
.
ejemplo Ejemplo: actualización de combinación de configuraciones
El siguiente ejemplo de configuración especifica cargar los registros del sistema y los registros de los com.example.HelloWorld
componentes en CloudWatch Logs.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
ejemplo Ejemplo: configuración para cargar varios archivos de registro activos mediante el administrador de registros v2.3.1
El siguiente ejemplo de configuración es el ejemplo recomendado si desea dirigirse a varios archivos de registro activos. En este ejemplo de configuración se especifican los archivos de registro activos en los que desea cargarlos CloudWatch. Si utiliza este ejemplo de configuración, la configuración también cargará todos los archivos rotados que coincidan con. logFileRegex
Este ejemplo de configuración es compatible con la versión 2.3.1 del administrador de registros.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.3.x
-
logsUploaderConfiguration
-
(Opcional) La configuración de los registros que carga el componente del administrador de registros. Este objeto contiene la siguiente información:
-
systemLogsConfiguration
-
(Opcional) La configuración de los registros del sistema del software AWS IoT Greengrass principal, que incluyen los registros del núcleo y los componentes del complemento de Greengrass. Especifique esta configuración para permitir que el componente gestor de registros gestione los registros del sistema. Este objeto contiene la siguiente información:
uploadToCloudWatch
-
(Opcional) Puede cargar los registros del sistema en CloudWatch Logs.
Valor predeterminado: false
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo se aplica solo si configura el componente núcleo de Greengrass para generar registros en formato JSON. Para habilitar los registros en formato JSON, especifique JSON
el parámetro de formato de registro (logging.format
).
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de los archivos de registro del sistema Greengrass, en la unidad en la que especifique. diskSpaceLimitUnit
Cuando el tamaño total de los archivos de registro del sistema Greengrass supera este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro del sistema Greengrass más antiguos.
Este parámetro equivale al parámetro de límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño máximo total del registro del sistema Greengrass.
diskSpaceLimitUnit
-
(Opcional) La unidad para. diskSpaceLimit
Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
-
componentLogsConfigurationMap
-
(Opcional) Un mapa de las configuraciones de registro de los componentes del dispositivo principal. Cada componentName
objeto de este mapa define la configuración de registro del componente o la aplicación. El componente del administrador de registros carga estos registros de componentes en CloudWatch Logs.
Si está actualizando desde una versión del administrador de registros anterior a la v2.2.0, puede seguir utilizando la lista en su lugar. componentLogsConfiguration
componentLogsConfigurationMap
Sin embargo, le recomendamos encarecidamente que utilice el formato de mapa para poder utilizar las actualizaciones de combinación y restablecimiento para modificar las configuraciones de componentes específicos. Para obtener información sobre el componentLogsConfiguration
parámetro, consulte los parámetros de configuración de la versión 2.1.x de este componente.
componentName
-
La configuración de registro del componentName
componente o la aplicación de esta configuración de registro. Puede especificar el nombre de un componente de Greengrass u otro valor para identificar este grupo de registros.
Cada objeto contiene la siguiente información:
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo solo se aplica si los registros de este componente utilizan un formato JSON específico, que se encuentra en el repositorio del módulo de AWS IoT Greengrass registro GitHub.
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de todos los archivos de registro de este componente, en la unidad en la que especifiquediskSpaceLimitUnit
. Cuando el tamaño total de los archivos de registro de este componente supere este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro más antiguos de este componente.
Este parámetro está relacionado con el parámetro límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño de registro total máximo para este componente.
diskSpaceLimitUnit
-
(Opcional) La unidad deldiskSpaceLimit
. Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
logFileDirectoryPath
-
(Opcional) La ruta a la carpeta que contiene los archivos de registro de este componente.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Valor predeterminado: /greengrass/v2
/logs
.
logFileRegex
-
(Opcional) Expresión regular que especifica el formato de nombre del archivo de registro que utiliza el componente o la aplicación. El componente gestor de registros utiliza esta expresión regular para identificar los archivos de registro de la carpeta situada enlogFileDirectoryPath
.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Si su componente o aplicación rota los archivos de registro, especifique una expresión regular que coincida con los nombres de los archivos de registro rotados. Por ejemplo, puede especificar hello_world\\\\w*.log
cargar los registros de una aplicación de Hello World. El \\\\w*
patrón coincide con cero o más caracteres de palabra, lo que incluye caracteres alfanuméricos y guiones bajos. Esta expresión regular hace coincidir los archivos de registro con y sin marcas de tiempo en su nombre. En este ejemplo, el administrador de registros carga los siguientes archivos de registro:
Predeterminado:componentName
\\\\w*.log
, donde componentName
es el nombre del componente de esta configuración de registro.
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
multiLineStartPattern
-
(Opcional) Expresión regular que identifica cuándo un mensaje de registro de una línea nueva es un mensaje de registro nuevo. Si la expresión regular no coincide con la nueva línea, el componente del administrador de registros anexa la nueva línea al mensaje de registro de la línea anterior.
De forma predeterminada, el componente del administrador de registros comprueba si la línea comienza con un carácter de espacio en blanco, como una pestaña o un espacio. Si no es así, el administrador de registros trata esa línea como un nuevo mensaje de registro. De lo contrario, añade esa línea al mensaje de registro actual. Este comportamiento garantiza que el componente del administrador de registros no divida los mensajes que ocupan varias líneas, como los seguimientos de pila.
-
periodicUploadIntervalSec
-
(Opcional) El período en segundos durante el que el componente del administrador de registros comprueba si hay nuevos archivos de registro para cargar.
Predeterminado: 300
(5 minutos)
Mínimo: 0.000001
(1 microsegundo)
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo de configuración especifica cargar los registros del sistema y los registros de los com.example.HelloWorld
componentes en CloudWatch Logs.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
ejemplo Ejemplo: configuración para cargar varios archivos de registro activos mediante el administrador de registros v2.3.1
El siguiente ejemplo de configuración es el ejemplo recomendado si desea dirigirse a varios archivos de registro activos. En este ejemplo de configuración se especifican los archivos de registro activos en los que desea cargarlos CloudWatch. Si utiliza este ejemplo de configuración, la configuración también cargará todos los archivos rotados que coincidan con. logFileRegex
Este ejemplo de configuración es compatible con la versión 2.3.1 del administrador de registros.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.2.x
-
logsUploaderConfiguration
-
(Opcional) La configuración de los registros que carga el componente del administrador de registros. Este objeto contiene la siguiente información:
-
systemLogsConfiguration
-
(Opcional) La configuración de los registros del sistema del software AWS IoT Greengrass principal, que incluyen los registros del núcleo y los componentes del complemento de Greengrass. Especifique esta configuración para permitir que el componente gestor de registros gestione los registros del sistema. Este objeto contiene la siguiente información:
uploadToCloudWatch
-
(Opcional) Puede cargar los registros del sistema en CloudWatch Logs.
Valor predeterminado: false
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo se aplica solo si configura el componente núcleo de Greengrass para generar registros en formato JSON. Para habilitar los registros en formato JSON, especifique JSON
el parámetro de formato de registro (logging.format
).
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de los archivos de registro del sistema Greengrass, en la unidad en la que especifique. diskSpaceLimitUnit
Cuando el tamaño total de los archivos de registro del sistema Greengrass supera este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro del sistema Greengrass más antiguos.
Este parámetro equivale al parámetro de límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño máximo total del registro del sistema Greengrass.
diskSpaceLimitUnit
-
(Opcional) La unidad para. diskSpaceLimit
Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
-
componentLogsConfigurationMap
-
(Opcional) Un mapa de las configuraciones de registro de los componentes del dispositivo principal. Cada componentName
objeto de este mapa define la configuración de registro del componente o la aplicación. El componente del administrador de registros carga estos registros de componentes en CloudWatch Logs.
Si está actualizando desde una versión del administrador de registros anterior a la 2.2.0, puede seguir utilizando la componentLogsConfiguration
lista en su lugar. componentLogsConfigurationMap
Sin embargo, le recomendamos encarecidamente que utilice el formato de mapa para poder utilizar las actualizaciones de combinación y restablecimiento para modificar las configuraciones de componentes específicos. Para obtener información sobre el componentLogsConfiguration
parámetro, consulte los parámetros de configuración de la versión 2.1.x de este componente.
componentName
-
La configuración de registro del componentName
componente o la aplicación de esta configuración de registro. Puede especificar el nombre de un componente de Greengrass u otro valor para identificar este grupo de registros.
Cada objeto contiene la siguiente información:
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo solo se aplica si los registros de este componente utilizan un formato JSON específico, que se encuentra en el repositorio del módulo de AWS IoT Greengrass registro GitHub.
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de todos los archivos de registro de este componente, en la unidad en la que especifiquediskSpaceLimitUnit
. Cuando el tamaño total de los archivos de registro de este componente supere este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro más antiguos de este componente.
Este parámetro está relacionado con el parámetro límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño de registro total máximo para este componente.
diskSpaceLimitUnit
-
(Opcional) La unidad deldiskSpaceLimit
. Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
logFileDirectoryPath
-
(Opcional) La ruta a la carpeta que contiene los archivos de registro de este componente.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Valor predeterminado: /greengrass/v2
/logs
.
logFileRegex
-
(Opcional) Expresión regular que especifica el formato de nombre del archivo de registro que utiliza el componente o la aplicación. El componente gestor de registros utiliza esta expresión regular para identificar los archivos de registro de la carpeta situada enlogFileDirectoryPath
.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Si su componente o aplicación rota los archivos de registro, especifique una expresión regular que coincida con los nombres de los archivos de registro rotados. Por ejemplo, puede especificar hello_world\\\\w*.log
cargar los registros de una aplicación de Hello World. El \\\\w*
patrón coincide con cero o más caracteres de palabra, lo que incluye caracteres alfanuméricos y guiones bajos. Esta expresión regular hace coincidir los archivos de registro con y sin marcas de tiempo en su nombre. En este ejemplo, el administrador de registros carga los siguientes archivos de registro:
Predeterminado:componentName
\\\\w*.log
, donde componentName
es el nombre del componente de esta configuración de registro.
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
multiLineStartPattern
-
(Opcional) Expresión regular que identifica cuándo un mensaje de registro de una línea nueva es un mensaje de registro nuevo. Si la expresión regular no coincide con la nueva línea, el componente del administrador de registros anexa la nueva línea al mensaje de registro de la línea anterior.
De forma predeterminada, el componente del administrador de registros comprueba si la línea comienza con un carácter de espacio en blanco, como una pestaña o un espacio. Si no es así, el administrador de registros trata esa línea como un nuevo mensaje de registro. De lo contrario, añade esa línea al mensaje de registro actual. Este comportamiento garantiza que el componente del administrador de registros no divida los mensajes que ocupan varias líneas, como los seguimientos de pila.
-
periodicUploadIntervalSec
-
(Opcional) El período en segundos durante el que el componente del administrador de registros comprueba si hay nuevos archivos de registro para cargar.
Predeterminado: 300
(5 minutos)
Mínimo: 0.000001
(1 microsegundo)
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo de configuración especifica cargar los registros del sistema y los registros de los com.example.HelloWorld
componentes en CloudWatch Logs.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
- v2.1.x
-
logsUploaderConfiguration
-
(Opcional) La configuración de los registros que carga el componente del administrador de registros. Este objeto contiene la siguiente información:
-
systemLogsConfiguration
-
(Opcional) La configuración de los registros del sistema del software AWS IoT Greengrass principal, que incluyen los registros del núcleo y los componentes del complemento de Greengrass. Especifique esta configuración para permitir que el componente gestor de registros gestione los registros del sistema. Este objeto contiene la siguiente información:
uploadToCloudWatch
-
(Opcional) Puede cargar los registros del sistema en CloudWatch Logs.
Valor predeterminado: false
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo se aplica solo si configura el componente núcleo de Greengrass para generar registros en formato JSON. Para habilitar los registros en formato JSON, especifique JSON
el parámetro de formato de registro (logging.format
).
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de los archivos de registro del sistema Greengrass, en la unidad en la que especifique. diskSpaceLimitUnit
Cuando el tamaño total de los archivos de registro del sistema Greengrass supera este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro del sistema Greengrass más antiguos.
Este parámetro equivale al parámetro de límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño máximo total del registro del sistema Greengrass.
diskSpaceLimitUnit
-
(Opcional) La unidad para. diskSpaceLimit
Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
-
componentLogsConfiguration
-
(Opcional) Una lista de las configuraciones de registro de los componentes del dispositivo principal. Cada configuración de esta lista define la configuración de registro de un componente o aplicación. El componente del administrador de registros carga estos registros de componentes en Logs CloudWatch
Cada objeto contiene la siguiente información:
componentName
-
El nombre del componente o la aplicación de esta configuración de registro. Puede especificar el nombre de un componente de Greengrass u otro valor para identificar este grupo de registros.
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo solo se aplica si los registros de este componente utilizan un formato JSON específico, que se encuentra en el repositorio del módulo de AWS IoT Greengrass registro GitHub.
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de todos los archivos de registro de este componente, en la unidad en la que especifiquediskSpaceLimitUnit
. Cuando el tamaño total de los archivos de registro de este componente supere este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro más antiguos de este componente.
Este parámetro está relacionado con el parámetro límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño de registro total máximo para este componente.
diskSpaceLimitUnit
-
(Opcional) La unidad deldiskSpaceLimit
. Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
logFileDirectoryPath
-
(Opcional) La ruta a la carpeta que contiene los archivos de registro de este componente.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Valor predeterminado: /greengrass/v2
/logs
.
logFileRegex
-
(Opcional) Expresión regular que especifica el formato de nombre del archivo de registro que utiliza el componente o la aplicación. El componente gestor de registros utiliza esta expresión regular para identificar los archivos de registro de la carpeta situada enlogFileDirectoryPath
.
No es necesario especificar este parámetro para los componentes de Greengrass que imprimen en salida estándar (stdout) y error estándar (stderr).
Si su componente o aplicación rota los archivos de registro, especifique una expresión regular que coincida con los nombres de los archivos de registro rotados. Por ejemplo, puede especificar hello_world\\\\w*.log
cargar los registros de una aplicación de Hello World. El \\\\w*
patrón coincide con cero o más caracteres de palabra, lo que incluye caracteres alfanuméricos y guiones bajos. Esta expresión regular hace coincidir los archivos de registro con y sin marcas de tiempo en su nombre. En este ejemplo, el administrador de registros carga los siguientes archivos de registro:
Predeterminado:componentName
\\\\w*.log
, donde componentName
es el nombre del componente de esta configuración de registro.
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
multiLineStartPattern
-
(Opcional) Expresión regular que identifica cuándo un mensaje de registro de una línea nueva es un mensaje de registro nuevo. Si la expresión regular no coincide con la nueva línea, el componente del administrador de registros anexa la nueva línea al mensaje de registro de la línea anterior.
De forma predeterminada, el componente del administrador de registros comprueba si la línea comienza con un carácter de espacio en blanco, como una pestaña o un espacio. Si no es así, el administrador de registros trata esa línea como un nuevo mensaje de registro. De lo contrario, añade esa línea al mensaje de registro actual. Este comportamiento garantiza que el componente del administrador de registros no divida los mensajes que ocupan varias líneas, como los seguimientos de pila.
-
periodicUploadIntervalSec
-
(Opcional) El período en segundos durante el que el componente del administrador de registros comprueba si hay nuevos archivos de registro para cargar.
Predeterminado: 300
(5 minutos)
Mínimo: 0.000001
(1 microsegundo)
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo de configuración especifica cargar los registros del sistema y los registros de los com.example.HelloWorld
componentes en CloudWatch Logs.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
- v2.0.x
-
logsUploaderConfiguration
-
(Opcional) La configuración de los registros que carga el componente del administrador de registros. Este objeto contiene la siguiente información:
systemLogsConfiguration
-
(Opcional) La configuración de los registros del sistema de software AWS IoT Greengrass principal. Especifique esta configuración para permitir que el componente gestor de registros gestione los registros del sistema. Este objeto contiene la siguiente información:
uploadToCloudWatch
-
(Opcional) Puede cargar los registros del sistema en CloudWatch Logs.
Valor predeterminado: false
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo se aplica solo si configura el componente núcleo de Greengrass para generar registros en formato JSON. Para habilitar los registros en formato JSON, especifique JSON
el parámetro de formato de registro (logging.format
).
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de los archivos de registro del sistema Greengrass, en la unidad en la que especifique. diskSpaceLimitUnit
Cuando el tamaño total de los archivos de registro del sistema Greengrass supera este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro del sistema Greengrass más antiguos.
Este parámetro equivale al parámetro de límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño máximo total del registro del sistema Greengrass.
diskSpaceLimitUnit
-
(Opcional) La unidad para. diskSpaceLimit
Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
componentLogsConfiguration
-
(Opcional) Una lista de las configuraciones de registro de los componentes del dispositivo principal. Cada configuración de esta lista define la configuración de registro de un componente o aplicación. El componente del administrador de registros carga estos registros de componentes en Logs CloudWatch
Cada objeto contiene la siguiente información:
componentName
-
El nombre del componente o la aplicación de esta configuración de registro. Puede especificar el nombre de un componente de Greengrass u otro valor para identificar este grupo de registros.
minimumLogLevel
-
(Opcional) El nivel mínimo de mensajes de registro que se deben cargar. Este nivel mínimo solo se aplica si los registros de este componente utilizan un formato JSON específico, que se encuentra en el repositorio del módulo de AWS IoT Greengrass registro GitHub.
Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:
Valor predeterminado: INFO
diskSpaceLimit
-
(Opcional) El tamaño total máximo de todos los archivos de registro de este componente, en la unidad en la que especifiquediskSpaceLimitUnit
. Cuando el tamaño total de los archivos de registro de este componente supere este tamaño total máximo, el software AWS IoT Greengrass Core elimina los archivos de registro más antiguos de este componente.
Este parámetro está relacionado con el parámetro límite de tamaño logarítmico (totalLogsSizeKB
) del componente núcleo de Greengrass. El software AWS IoT Greengrass Core utiliza el mínimo de los dos valores como tamaño de registro total máximo para este componente.
diskSpaceLimitUnit
-
(Opcional) La unidad deldiskSpaceLimit
. Puede elegir entre las siguientes opciones:
-
KB
— kilobytes
-
MB
— megabytes
-
GB
— gigabytes
Valor predeterminado: KB
logFileDirectoryPath
-
La ruta a la carpeta que contiene los archivos de registro de este componente.
Para cargar los registros de un componente de Greengrass/greengrass/v2
/logs
, especifique y reemplácelos por su carpeta /greengrass/v2
raíz de Greengrass.
logFileRegex
-
Expresión regular que especifica el formato de nombre del archivo de registro que utiliza el componente o la aplicación. El componente gestor de registros utiliza esta expresión regular para identificar los archivos de registro de la carpeta en la que se encuentralogFileDirectoryPath
.
Para cargar los registros de un componente de Greengrass, especifique una expresión regular que coincida con los nombres de los archivos de registro rotados. Por ejemplo, puede especificar com.example.HelloWorld\\w*.log
cargar los registros de un componente de Hello World. El \\w*
patrón coincide con cero o más caracteres de palabra, lo que incluye caracteres alfanuméricos y guiones bajos. Esta expresión regular hace coincidir los archivos de registro con y sin marcas de tiempo en su nombre. En este ejemplo, el administrador de registros carga los siguientes archivos de registro:
-
com.example.HelloWorld.log
— El archivo de registro más reciente del componente Hello World.
-
com.example.HelloWorld_2020_12_15_17_0.log
— Un archivo de registro antiguo para el componente Hello World. El núcleo de Greengrass añade una marca de tiempo rotativa a los archivos de registro.
deleteLogFileAfterCloudUpload
-
(Opcional) Puede eliminar un archivo de registro después de que el componente del administrador de registros cargue los registros en Logs. CloudWatch
Valor predeterminado: false
multiLineStartPattern
-
(Opcional) Expresión regular que identifica cuándo un mensaje de registro de una línea nueva es un mensaje de registro nuevo. Si la expresión regular no coincide con la nueva línea, el componente del administrador de registros anexa la nueva línea al mensaje de registro de la línea anterior.
De forma predeterminada, el componente del administrador de registros comprueba si la línea comienza con un carácter de espacio en blanco, como una pestaña o un espacio. Si no es así, el administrador de registros trata esa línea como un nuevo mensaje de registro. De lo contrario, añade esa línea al mensaje de registro actual. Este comportamiento garantiza que el componente del administrador de registros no divida los mensajes que ocupan varias líneas, como los seguimientos de pila.
periodicUploadIntervalSec
-
(Opcional) El período en segundos durante el que el componente del administrador de registros comprueba si hay nuevos archivos de registro para cargar.
Predeterminado: 300
(5 minutos)
Mínimo: 0.000001
(1 microsegundo)
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo de configuración especifica cargar los registros del sistema y los registros de los com.example.HelloWorld
componentes en CloudWatch Logs.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"logFileDirectoryPath": "/greengrass/v2/logs",
"logFileRegex": "com.example.HelloWorld\\w*.log",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
Uso
El componente del administrador de registros se carga en los siguientes grupos de registros y flujos de registros.
- 2.1.0 and later
-
- Nombre del grupo de registros
-
/aws/greengrass/componentType
/region
/componentName
El nombre del grupo de registros utiliza las siguientes variables:
-
componentType
— El tipo de componente, que puede ser uno de los siguientes:
-
GreengrassSystemComponent
— Este grupo de registros incluye los registros de los componentes del núcleo y del complemento, que se ejecutan en la misma JVM que el núcleo de Greengrass. El componente forma parte del núcleo de Greengrass.
-
UserComponent
— Este grupo de registros incluye registros de componentes genéricos, componentes de Lambda y otras aplicaciones del dispositivo. El componente no forma parte del núcleo de Greengrass.
Para obtener más información, consulte Tipos de componentes.
-
region
— La AWS región que utiliza el dispositivo principal.
-
componentName
— El nombre del componente. Para los registros del sistema, este valor esSystem
.
- Nombre del flujo de registro
-
/date
/thing/thingName
El nombre del flujo de registro utiliza las siguientes variables:
-
date
— La fecha del registro, por ejemplo2020/12/15
. El componente del administrador de registros usa el yyyy/MM/dd
formato.
-
thingName
— El nombre del dispositivo principal.
Si el nombre de un elemento contiene dos puntos (:
), el administrador de registros los sustituye por un signo más (+
).
- 2.0.x
-
- Nombre del grupo de registros
-
/aws/greengrass/componentType
/region
/componentName
El nombre del grupo de registros utiliza las siguientes variables:
-
componentType
— El tipo de componente, que puede ser uno de los siguientes:
-
GreengrassSystemComponent
— El componente forma parte del núcleo de Greengrass.
-
UserComponent
— El componente no forma parte del núcleo de Greengrass. El administrador de registros usa este tipo para los componentes de Greengrass y otras aplicaciones del dispositivo.
-
region
— La AWS región que utiliza el dispositivo principal.
-
componentName
— El nombre del componente. Para los registros del sistema, este valor esSystem
.
- Nombre del flujo de registro
-
/date
/deploymentTargets
/thingName
El nombre del flujo de registro utiliza las siguientes variables:
-
date
— La fecha del registro, por ejemplo2020/12/15
. El componente del administrador de registros usa el yyyy/MM/dd
formato.
-
deploymentTargets
— Las cosas cuyas implementaciones incluyen el componente. El componente del administrador de registros separa cada objetivo mediante una barra oblicua. Si el componente se ejecuta en el dispositivo principal como resultado de una implementación local, este valor esLOCAL_DEPLOYMENT
.
Considere un ejemplo en el que tiene un nombre MyGreengrassCore
para un dispositivo principal y el dispositivo principal tiene dos implementaciones:
-
Una implementación dirigida al dispositivo principal,MyGreengrassCore
.
-
Una implementación que se dirige a un grupo de cosas denominadoMyGreengrassCoreGroup
, que contiene el dispositivo principal.
Los deploymentTargets
de este dispositivo principal sonthing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup
.
-
thingName
— El nombre del dispositivo principal.
Formatos de entradas de registro.
El núcleo de Greengrass escribe los archivos de registro en formato de cadena o JSON. En el caso de los registros del sistema, usted controla el formato configurando el format
campo de la logging
entrada. Puede encontrar la logging
entrada en el archivo de configuración del componente núcleo de Greengrass. Para obtener más información, consulte Configuración del núcleo de Greengrass.
El formato de texto es de formato libre y acepta cualquier cadena. El siguiente mensaje del servicio de estado de la flota es un ejemplo de registro con formato de cadena:
2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published.
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService,
currentState=RUNNING}
Debe usar el formato JSON si quiere ver los registros con el comando logs de la CLI de Greengrass o interactuar con los registros mediante programación. El siguiente ejemplo describe la forma JSON:
{
"loggerName": <string>,
"level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
"eventType": <string, optional>,
"cause": <string, optional>,
"contexts": {},
"thread": <string>,
"message": <string>,
"timestamp": <epoch time> # Needs to be epoch time
}
Para controlar la salida de los registros de su componente, puede usar la opción minimumLogLevel
de configuración. Para usar esta opción, el componente debe escribir sus entradas de registro en formato JSON. Debe usar el mismo formato que el archivo de registro del sistema.
Archivo de registro local
Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.
- Linux
-
/greengrass/v2
/logs/greengrass.log
- Windows
-
C:\greengrass\v2
\logs\greengrass.log
Para ver los registros de este componente
Registros de cambios
En la siguiente tabla se describen los cambios en cada versión del componente.
Versión
|
Cambios
|
2.3.7
|
Versión actualizada para la versión 2.12.0 de Greengrass nucleus.
|
2.3.6
|
- Mejoras y correcciones de errores
-
|
2.3.5
|
- Mejoras
-
Mejora la velocidad de carga de los registros.
Versión actualizada para la versión 2.11.0 de Greengrass nucleus. |
2.3.4
|
- Mejoras y correcciones de errores
-
-
Añade soporte para configurar el periodicUploadIntervalSec parámetro en valores fraccionarios. El mínimo es 1 microsegundo.
-
Soluciona un problema por el que el administrador de registros no respetaba los CloudWatch putLogEvents límites.
|
2.3.3
|
Versión actualizada para la versión 2.10.0 de Greengrass nucleus.
|
2.3.2
|
- Mejoras y correcciones de errores
-
-
Mejora la gestión del espacio para que los archivos de registro no se eliminen antes de cargarlos.
-
Soluciona problemas con la administración de la memoria caché.
-
Mejoras y correcciones de errores menores adicionales.
|
2.3.1
|
- Mejoras y correcciones de errores
-
-
Soluciona un problema por el que los grupos de archivos de destino con varios archivos de registro activos cargaban entradas duplicadas en ellas. CloudWatch
-
Mejoras y correcciones de errores menores adicionales.
|
2.3.0
|
Le recomendamos que actualice a Greengrass nucleus 2.9.1 cuando actualice a log manager 2.3.0.
- Nuevas características
-
Reduce las demoras en el registro al procesar y cargar directamente los archivos de registro activos en lugar de esperar a que se roten los archivos nuevos.
- Mejoras y correcciones de errores
-
|
2.2.8
|
Versión actualizada para la versión 2.9.0 de Greengrass Nucleus. |
2.2.7
|
Versión actualizada para el lanzamiento de la versión 2.8.0 de Greengrass nucleus. |
2.2.6
|
Versión actualizada para el lanzamiento de la versión 2.7.0 de Greengrass nucleus.
|
2.2.5
|
Versión actualizada para la versión 2.6.0 de Greengrass Nucleus.
|
2.2.4
|
- Mejoras y correcciones de errores
-
|
2.2.3
|
- Mejoras y correcciones de errores
-
-
Mejora la estabilidad en ciertos escenarios en los que el componente se reinicia o encuentra errores.
-
Soluciona problemas por los que los mensajes de registro y los archivos de registro de gran tamaño no se cargaban en determinadas situaciones.
-
Soluciona problemas relacionados con la forma en que este componente gestiona las actualizaciones de restablecimiento de la configuración.
-
Soluciona un problema por el que un valor de null diskSpaceLimit configuración impedía la implementación del componente.
|
2.2.2
|
- Mejoras y correcciones de errores
-
|
2.2.1
|
Versión actualizada para el lanzamiento de la versión 2.5.0 de Greengrass nucleus.
|
2.2.0
|
|
2.1.3
|
Versión actualizada para la versión 2.4.0 de Greengrass Nucleus.
|
2.1.2
|
Versión actualizada para el lanzamiento de la versión 2.3.0 de Greengrass nucleus.
|
2.1.1
|
- Mejoras y correcciones de errores
-
|
2.1.0
|
- Mejoras y correcciones de errores
-
-
Utilice valores predeterminados para logFileDirectoryPath y logFileRegex que funcionen para los componentes de Greengrass que imprimen con salida estándar (stdout) y error estándar (stderr).
-
Dirija correctamente el tráfico a través de un proxy de red configurado al cargar registros en Logs. CloudWatch
-
Maneje correctamente los dos puntos (: ) en los nombres de los flujos de registro. CloudWatch Los nombres de los flujos de registro de registros no admiten signos de dos puntos.
-
Simplifique los nombres de los flujos de registro eliminando los nombres de los grupos de cosas del flujo de registro.
-
Elimine un mensaje de registro de errores que se imprime con un comportamiento normal.
|
2.0.x
|
Versión inicial.
|