pcluster export-cluster-logs - AWS ParallelCluster
Argumentos con nombre¿No puede recuperar los registros?

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.

pcluster export-cluster-logs

Exporte los registros del clúster a un archivo tar.gz local pasándolos por un bucket de Amazon S3.

pcluster export-cluster-logs [-h]
                 --cluster-name CLUSTER_NAME
                [--bucket BUCKET_NAME]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]
                [--end-time END_TIME]
                [--filters FILTER [FILTER ...]]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
nota

El export-cluster-logs comando espera a que CloudWatch Logs complete la exportación de los registros, por lo que se espera que pase un período de tiempo sin ningún resultado.

Argumentos con nombre

-h, --help

Muestra el texto de ayuda de pcluster export-cluster-logs.

--bucket BUCKET_NAME

Especifica el nombre del bucket de Amazon S3 al que se exportarán los datos de los registros del clúster. Tiene que estar en la misma región que el clúster.

nota

  • Debe añadir permisos a la política de buckets de Amazon S3 para conceder el CloudWatch acceso. Para obtener más información, consulte Establecer permisos en un bucket de Amazon S3 en la Guía del usuario de CloudWatch Logs.

  • A partir de AWS ParallelCluster la versión 3.12.0, la --bucket opción es opcional. Si no se especifica la opción, se utilizará el bucket predeterminado AWS ParallelCluster regional (parallelcluster-hash-v1-DO-NOT-DELETE) o si se especifica el bucket de Amazon S3 al CustomS3Bucket que apunta en la configuración del clúster, se utilizará ese bucket. Si no especifica la --bucket opción y utiliza el AWS ParallelCluster bucket predeterminado, no podrá exportar los registros a la parallelcluster/ carpeta, ya que se trata de una carpeta protegida reservada para uso interno.

importante

Si se usa el depósito AWS ParallelCluster predeterminado, pcluster se encargará de configurar la política del depósito. Si personalizó la política de bucket y, a continuación, la AWS ParallelCluster actualizó a la versión 3.12.0, la política de bucket se anulará y tendrá que volver a aplicar los cambios.

--cluster-name, -n CLUSTER_NAME

Especifica el nombre del clúster.

--bucket-prefix BUCKET_PREFIX

Especifica la ruta en el bucket de Amazon S3 donde se almacenará la información de los registros exportados.

De forma predeterminada, el prefijo del bucket es:

cluster-name-logs-202209061743.tar.gz

202209061743es un ejemplo de la hora en formato. %Y%m%d%H%M

nota

A partir de la AWS ParallelCluster versión 3.12.0, si no especifica la --bucket opción y utiliza el AWS ParallelCluster depósito predeterminado, no podrá exportar los registros a la parallelcluster/ carpeta, ya que se trata de una carpeta protegida reservada para uso interno.

--debug

Habilita del registro de depuración.

--end-time END_TIME

Especifica el final del intervalo de tiempo para recopilar los eventos del registro, expresado en formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por ejemplo 2021-01-01T20:00:00Z). No se incluyen los eventos con una marca de tiempo igual o posterior a esta hora. Se pueden omitir los elementos de tiempo (por ejemplo, minutos y segundos). El valor predeterminado es la hora actual.

--filters FILTER [FILTER ...]

Especifica los filtros para el registro. Formato: Name=a,Values=1 Name=b,Values=2,3. Los filtros compatibles son:

private-dns-name

Especifica la forma abreviada del nombre de DNS privado de la instancia (por ejemplo ip-10-0-0-101).

node-type

Especifica el tipo de nodo, el único valor aceptado para este filtro es HeadNode.

--keep-s3-objects KEEP_S3_OBJECTS

Si se establece en true, se conservan las exportaciones de objetos exportados a Amazon S3. (el valor predeterminado es false).

--output-file OUTPUT_FILE

Especifica la ruta del archivo en la que se guardará el archivo de registro. Si se proporciona, los registros se guardan localmente. De lo contrario, se cargan en Amazon S3 con la URL devuelta en la salida. De forma predeterminada, se cargan en Amazon S3.

--region, -r REGION

Especifica el que se va Región de AWS a utilizar. Región de AWS Debe especificarse mediante la variable de AWS_DEFAULT_REGION entorno, la region configuración de la [default] sección del ~/.aws/config archivo o el --region parámetro.

--start-time START_TIME

Especifica el inicio del intervalo de tiempo, expresado en formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por ejemplo 2021-01-01T20:00:00Z). Se incluyen los eventos de registro con una marca de tiempo igual o posterior a esta hora. Si no se especifica, el valor predeterminado es la hora en que se creó el clúster.

Ejemplo que utiliza AWS ParallelCluster la versión 3.1.4:

$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
  "url": "https://cluster-v3-bucket..."
}

¿No puede recuperar los registros?

Si no puede recuperar los registros mediante el export-cluster-logs comando, siga uno de estos procedimientos:

  • Recupere los registros manualmente del grupo de CloudWatch registros del clúster.

  • Si el grupo de registros está vacío, utilice SSH en los nodos del clúster y recupere los registros que figuran en Solución de problemas de inicialización de nodos él.

  • Si no se puede acceder a los nodos del clúster porque el clúster no se pudo crear, vuelva a crear el clúster con la opción --rollback-on-failure false y recupere los registros de los nodos.