Supervisión de la puerta de enlace de archivo de S3 - AWS Storage Gateway
Obtención de registros de estado de la puerta de enlace de archivo de S3Uso de métricas de Amazon CloudWatchRecepción de notificaciones sobre las operaciones de archivosInformación acerca de las métricas de gatewayDescripción de las métricas de recursos compartidos de archivosDescripción de los registros de auditoría de la puerta de enlace de archivo de S3

Supervisión de la puerta de enlace de archivo de S3

Puede supervisar la puerta de enlace de archivo de S3 y los recursos asociados en AWS Storage Gateway mediante las métricas y los registros de auditoría de Amazon CloudWatch. También puede usar Eventos de CloudWatch para recibir notificaciones cuando se terminen las operaciones con los archivos.

Obtención de registros de estado de la puerta de enlace de archivo de S3 con los grupos de registro de CloudWatch

Puede utilizar Registros de Amazon CloudWatch para obtener información acerca del estado de la puerta de enlace de archivo de S3 y los recursos relacionados. Puede utilizar los registros para supervisar los errores que detecte la puerta de enlace. Además, puede utilizar los filtros de suscripción de Amazon CloudWatch para automatizar el procesamiento de la información de los registros en tiempo real. Para obtener más información, consulte Procesamiento en tiempo real de datos de registros con suscripciones en la Guía del usuario de Amazon CloudWatch.

Por ejemplo, puede configurar un grupo de registro de CloudWatch para supervisar la puerta de enlace y recibir notificaciones cuando la puerta de enlace de archivo de S3 falle al cargar los archivos en un bucket de Amazon S3. Puede configurar el grupo cuando active la puerta de enlace o cuando esta ya esté activada y en funcionamiento. Para obtener información acerca de cómo configurar un grupo de registros de CloudWatch al activar una puerta de enlace, consulte Configurar la puerta de enlace de archivo de Amazon S3. Para obtener más información, consulte Trabajo con flujos de grupos y flujos de registros en la Guía del usuario de Amazon CloudWatch.

A continuación se muestra un ejemplo de un error notificado por una puerta de enlace de archivo de S3. 

{
    "severity": "ERROR",
    "bucket": "bucket-smb-share2",
    "roleArn": "arn:aws:iam::123456789012:role/amzn-s3-demo-bucket",
    "source": "share-E1A2B34C",
    "type": "InaccessibleStorageClass",
    "operation": "S3Upload",
    "key": "myFolder/myFile.text",
    "gateway": "sgw-B1D123D4",
    "timestamp": "1565740862516"
}

Este error significa que la puerta de enlace de archivo de S3 no puede cargar el objeto myFolder/myFile.text en Amazon S3 porque ha cambiado de la clase de almacenamiento Amazon S3 Standard a la clase de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive.

En el registro del estado de la gateway anterior, estos elementos especifican una información determinada:

  • source: share-E1A2B34C indica el recurso compartido de archivos que ha detectado este error.

  • "type": "InaccessibleStorageClass" indica el tipo de error que se ha producido. En este caso, se ha detectado el error cuando la puerta de enlace intentaba cargar el objeto especificado en Amazon S3 o realizar una lectura desde Amazon S3. Sin embargo, en este caso el objeto ha cambiado a Amazon Glacier. El valor de "type" puede ser cualquier error que la puerta de enlace de archivo de S3 detecte. Para obtener una lista de posibles errores, consulte Solución de problemas: problemas con la puerta de enlace de archivo.

  • "operation": "S3Upload" indica que este error se ha producido cuando la puerta de enlace intentaba cargar este objeto en S3.

  • "key": "myFolder/myFile.text" indica el objeto que ha provocado el fallo.

  • gateway": "sgw-B1D123D4 indica la puerta de enlace de archivo de S3 que ha detectado este error.

  • "timestamp": "1565740862516" indica el momento en el que se ha producido el error.

Para obtener información sobre cómo solucionar los errores que puede notificar la puerta de enlace de archivo de S3, consulte Solución de problemas: problemas con la puerta de enlace de archivo.

Configuración de un grupo de registro de CloudWatch después de activar la puerta de enlace

El siguiente procedimiento muestra cómo configurar un grupo de registro de CloudWatch después de activar la puerta de enlace.

Para configurar un grupo de registro de CloudWatch para que funcione con la puerta de enlace de archivo de S3

  1. Inicie sesión en Consola de administración de AWS y abra la consola de Storage Gateway en https://console.aws.amazon.com/storagegateway/home.

  2. En el panel de navegación, elija Puertas de enlace y, a continuación, elija la puerta de enlace para la que desea configurar el grupo de registro de CloudWatch.

  3. En Acciones, seleccione Editar información de puerta de enlace.

  4. En Elegir cómo configurar el grupo de registro, elija una de las siguientes opciones:

    • Crear un nuevo grupo de registro para crear un grupo de registro de CloudWatch.

    • Utilizar un grupo de registro existente para usar un grupo de registro de CloudWatch que ya existe.

      Elija un grupo de registro de la Lista de grupos de registros existentes.

    • Seleccione Desactivar el registro si no quiere supervisar la puerta de enlace mediante grupos de registro de CloudWatch.

  5. Seleccione Save changes (Guardar cambios).

  6. Para consultar los registros del estado de la puerta de enlace, haga lo siguiente:

    1. En el panel de navegación, elija Puertas de enlace y, a continuación, elija la puerta de enlace para la que configuró el grupo de registro de CloudWatch.

    2. Seleccione la pestaña Detalles y, en Registros de estado, elija Registros de CloudWatch. Se abre la página Detalles del grupo de registro en la consola de CloudWatch.

Uso de métricas de Amazon CloudWatch

Puede obtener datos de supervisión de la puerta de enlace de archivo de S3 mediante la Consola de administración de AWS o la API de CloudWatch. La consola muestra una serie de gráficos basados en los datos sin procesar de la API de CloudWatch. También puede usar la API de CloudWatch a través de uno de los SDK de AWS o las herramientas de la API de Amazon CloudWatch. En función de sus necesidades, es posible que prefiera utilizar los gráficos que se muestran en la consola o que se recuperan de la API.

Independientemente del método que utilice para trabajar con las métricas, debe especificar la siguiente información:

  • La dimensión de las métricas con las que va a trabajar. Una dimensión es un par de nombre-valor que le ayuda a identificar una métrica de forma inequívoca. Las dimensiones de Storage Gateway son GatewayId yGatewayName. En la consola de CloudWatch, puede utilizar la vista Gateway Metrics para seleccionar fácilmente dimensiones específicas de la puerta de enlace. Para obtener más información acerca de las dimensiones, consulte Dimensiones en la Guía del usuario de Amazon CloudWatch.

  • El nombre de la métrica, como ReadBytes.

En la tabla siguiente se indican los tipos de datos de métricas de Storage Gateway que están disponibles para usted.

Espacio de nombres de Amazon CloudWatch Dimensión Descripción
AWS/StorageGateway GatewayId, GatewayName

Estas dimensiones filtran datos de métricas que describen aspectos de la gateway. Puede identificar una puerta de enlace de archivo de S3 con la que trabajar especificando las dimensiones GatewayId y GatewayName.

Los datos de velocidad y latencia de una gateway se basan en todos los archivos compartidos en la gateway.

Los datos se encuentran disponibles automáticamente en periodos de 5 minutos sin costo alguno.

Trabajar con métricas de gateway y de archivos es similar a trabajar con otras métricas de servicio. Puede encontrar información sobre algunas de las métricas más comunes en la documentación de CloudWatch que se muestra a continuación:

Recepción de notificaciones sobre las operaciones de archivos

Storage Gateway puede iniciar los siguientes Eventos de CloudWatch cuando se completan las operaciones de archivos:

  • Puede recibir una notificación cuando la puerta de enlace termine de cargar archivos de forma asíncrona desde el recurso compartido de archivos en Amazon S3. Utilice el parámetro NotificationPolicy para solicitar una notificación de carga de archivos. Esto envía una notificación por cada carga de archivos completada en Amazon S3. Para obtener más información, consulte Recepción de una notificación de carga de archivos.

  • Puede recibir una notificación cuando la puerta de enlace termine de cargar el conjunto de archivos de trabajo de forma asíncrona desde el recurso compartido de archivos en Amazon S3. Utilice la operación de la API NotifyWhenUploaded para solicitar una notificación de carga de un conjunto de archivos de trabajo. Esto envía una notificación cuando todos los archivos del conjunto de archivos de trabajo se han cargado en Amazon S3. Para obtener más información, consulte Recepción de una notificación de carga del conjunto de archivos de trabajo.

  • Puede recibir una notificación cuando la gateway termine de actualizar la caché para el bucket de S3. Al invocar la operación RefreshCache desde la consola o la API de Storage Gateway, suscríbase para recibir una notificación cuando finalice la operación. Para obtener más información, consulte Recepción de una notificación de actualización de la caché.

Cuando finalice la operación de archivos que ha solicitado, Storage Gateway le enviará una notificación a través de Eventos de CloudWatch. Puede configurar Eventos de CloudWatch para que envíe la notificación a través de destinos de eventos como Amazon SNS, Amazon SQS o una función de AWS Lambda. Por ejemplo, puede configurar un destino de Amazon SNS para que envíe la notificación a los consumidores de Amazon SNS, por ejemplo, por correo electrónico y mensaje de texto. Para obtener más información sobre Eventos de CloudWatch, consulte ¿Qué es CloudWatch Events?

Para configurar la notificación de Eventos de CloudWatch

  1. Cree un destino, como un tema de Amazon SNS o una función de Lambda, para invocarlo cuando se produzca el evento que solicitó en Storage Gateway.

  2. Cree una regla en la consola de Eventos de CloudWatch para invocar destinos en función de un evento en Storage Gateway.

  3. En la regla, cree un patrón de eventos para el tipo de evento. La notificación se envía cuando el evento coincide con este patrón de reglas.

  4. Seleccione el destino y configure los ajustes.

En el siguiente ejemplo, se muestra una regla que inicia el tipo de evento especificado en la puerta de enlace y en la Región de AWS especificada. Por ejemplo, puede especificar Storage Gateway File Upload Event como tipo de evento.

{
   "source":[
      "aws.storagegateway"
   ],
   "resources":[
      "arn:aws:storagegateway:AWS Region:account-id
                 :gateway/gateway-id"
   ],
   "detail-type":[
      "Event type"
   ]
}

Para obtener más información sobre cómo usar las reglas de Eventos de CloudWatch, consulte Creación de una regla de Eventos de CloudWatch que se activa en función de un evento en Guía del usuario de Eventos de Amazon CloudWatch.

Recepción de una notificación de carga de archivos

Existen dos casos de uso en los que puede utilizar la notificación de carga de archivos:

  • Para la automatización del procesamiento en la nube de los archivos que se cargan, puede llamar al parámetro NotificationPolicy y obtener un ID de notificación. La notificación que tiene lugar cuando se cargan archivos tiene el mismo ID de notificación que el que devuelve la API. Si utiliza este ID de notificación para realizar un seguimiento de la lista de archivos que está cargando, puede iniciar el procesamiento del archivo que se ha cargado en AWS cuando se genere el evento con el mismo ID.

  • Para los casos de uso de distribución de contenido, podría tener dos puertas de enlace de archivo de S3 asignadas al mismo bucket de Amazon S3. El cliente del recurso compartido de archivos de la puerta de enlace 1 podría cargar los archivos nuevos en Amazon S3 y los clientes del recurso compartido de archivos de la puerta de enlace 2 podrían leerlos. Los archivos se cargan en Amazon S3, pero la puerta de enlace 2 no puede verlos porque utiliza una versión almacenada locamente en caché de los archivos de Amazon S3. Para que los archivos sean visibles en la puerta de enlace 2, puede utilizar el parámetro NotificationPolicy para solicitar la notificación de carga de archivos a la puerta de enlace 1 para que le envíe una notificación cuando haya terminado la carga del archivo. A continuación, puede utilizar Eventos de CloudWatch para enviar automáticamente una solicitud RefreshCache para el recurso compartido de archivos en la puerta de enlace 2. Cuando se completa la solicitud RefreshCache, el nuevo archivo es visible en la puerta de enlace 2.

ejemplo Ejemplo: Notificación de carga de archivos

En el siguiente ejemplo, se muestra una notificación de carga de archivos que se envía a través de CloudWatch cuando el evento coincide con la regla que ha creado. Esta notificación está en formato JSON. Puede configurar esta notificación para que se entregue al destino en un mensaje de texto. El valor de detail-type es Storage Gateway Object Upload Event.

{
    "version": "0",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Object Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2020-11-05T12:34:56Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:storagegateway:us-east-1:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-1:123456789011:gateway/sgw-712345DA",
        "arn:aws:s3:::do-not-delete-bucket"
    ],
    "detail": {
        "object-size": 1024,
        "modification-time": "2020-01-05T12:30:00Z",
        "object-key": "my-file.txt",
        "event-type": "object-upload-complete",        
        "prefix": "prefix/",
        "bucket-name": "amzn-s3-demo-bucket",  
    }
}

Nombres de los campos

Descripción

versión

Versión actual de la política de IAM.

id

ID que identifica la política de IAM.

tipo-detalle

Descripción del evento que inició la notificación que se envió.

origen

Servicio de AWS que es el origen de la solicitud y la notificación.

inscrita

ID de la cuenta de AWS donde se generaron la solicitud y la notificación.

hora

Fecha y hora en el que se realizó la solicitud de carga de archivos en Amazon S3.

region

Región de AWS desde la que se enviaron la solicitud y la notificación.

recursos

Recursos de Storage Gateway a los que se aplica la política.

tamaño de objeto

El tamaño del objeto, en bytes.

hora de modificación

La hora en que el cliente modificó el archivo.

clave de objeto

La ruta al archivo .

event-type

Los Eventos de CloudWatch que iniciaron la notificación.

prefix

Nombre del prefijo del bucket de S3.

bucket-name

Nombre del bucket de S3.

Recepción de una notificación de carga del conjunto de archivos de trabajo

Existen dos casos de uso para los que puede utilizar la notificación de carga de conjunto del archivos de trabajo:

  • Para la automatización del procesamiento en la nube de los archivos que se cargan, puede llamar a la API NotifyWhenUploaded y obtener un ID de notificación. La notificación que se activa cuando se cargan el conjunto de archivos de trabajo tiene el mismo ID de notificación que el que devuelve la API. Si utiliza este ID de notificación para realizar un seguimiento de la lista de archivos que está cargando, puede iniciar el procesamiento del conjunto de archivos de trabajo que se han cargado en AWS cuando se genere un evento con el mismo ID.

  • Para los casos de uso de distribución de contenido, podría tener dos puertas de enlace de archivo de S3 asignadas al mismo bucket de Amazon S3. El cliente del recurso compartido de archivos de la puerta de enlace 1 podría cargar los archivos nuevos en Amazon S3 y los clientes del recurso compartido de archivos de la puerta de enlace 2 podrían leerlos. Los archivos se cargan en Amazon S3, pero la puerta de enlace 2 no puede verlos porque utiliza una versión almacenada locamente en caché de los archivos de S3. Para que los archivos sean visibles en la puerta de enlace 2, puede utilizar operación de la API NotifyWhenUploaded para solicitar la notificación de carga de archivos en la puerta de enlace 1 para que le envíe una notificación cuando haya terminado la carga. A continuación, puede utilizar Eventos de CloudWatch para enviar automáticamente una solicitud RefreshCache para el recurso compartido de archivos en la puerta de enlace 2. Cuando se completa la solicitud RefreshCache, los nuevos archivos son visibles en la puerta de enlace 2. Esta operación no importa archivos al almacenamiento en caché de la puerta de enlace. Solo actualiza el inventario en caché para reflejar los cambios en el inventario de los objetos en el bucket de S3.

ejemplo Ejemplo: Notificación de carga del conjunto de archivos de trabajo

En el siguiente ejemplo, se muestra una notificación de carga de un conjunto de archivos de trabajo que se envían a través de CloudWatch cuando el evento coincide con la regla que ha creado. Esta notificación está en formato JSON. Puede configurar esta notificación para que se entregue al destino en un mensaje de texto. El valor de detail-type es Storage Gateway File Upload Event.

{
    "version": "2012-10-17",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway File Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "upload-complete",
        "notification-id": "11b3106b-a18a-4890-9d47-a1a755ef5e47",
        "request-received": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z"
    }
}

Nombres de los campos

Descripción

versión

Versión actual de la política de IAM.

id

ID que identifica la política de IAM.

tipo-detalle

Descripción del evento que inició la notificación que se envió.

origen

Servicio de AWS que es el origen de la solicitud y la notificación.

inscrita

ID de la cuenta de AWS donde se generaron la solicitud y la notificación.

hora

Fecha y hora en el que se realizó la solicitud de carga de archivos en Amazon S3.

region

Región de AWS desde la que se enviaron la solicitud y la notificación.

recursos

Recursos de Storage Gateway a los que se aplica la política.

event-type

Los Eventos de CloudWatch que iniciaron la notificación.

notification-id

ID generado de forma aleatoria de la notificación que se envió. Este ID tiene el formato UUID. Este es el ID de notificación que se devuelve cuando se llama a NotifyWhenUploaded.

request-received

Fecha y hora en que la gateway recibió la solicitud NotifyWhenUploaded.

completed

Fecha y hora en que se cargaron todos los archivos del conjunto de trabajo en Amazon S3.

Recepción de una notificación de actualización de la caché

En el caso de uso de una notificación de actualización de la caché, puede tener dos puertas de enlace de archivo de S3 asignados al mismo bucket de Amazon S3 y el cliente NFS de la puerta de enlace 1 podría cargar archivos nuevos en el bucket de S3. Los archivos se cargan en S3, pero no aparecen en la puerta de enlace 2 hasta que se actualice la caché. Esto se debe a que la puerta de enlace 2 utiliza una versión almacenada localmente en caché de los archivos de Amazon S3. Es posible que desee hacer algo con los archivos de Gateway2 una vez que finalice la actualización de la caché. Los archivos de gran tamaño pueden tardar algún tiempo en aparecer en la puerta de enlace 2, por lo que puede interesarle recibir una notificación cuando haya finalizado la actualización de la caché. Puede solicitar una notificación de actualización de la caché a Gateway2 para que le avise cuando todos los archivos estén visibles en Gateway2.

ejemplo Ejemplo: Notificación de actualización de la caché

En el siguiente ejemplo, se muestra una notificación de actualización de la caché que se envía a través de CloudWatch cuando el evento coincide con la regla que se ha creado. Esta notificación está en formato JSON. Puede configurar esta notificación para que se entregue al destino en un mensaje de texto. El valor de detail-type es Storage Gateway Refresh Cache Event.

{
    "version": "2012-10-17",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Refresh Cache Event",
    "source": "aws.storagegateway",
    "account": "209870788375",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "refresh-complete",
        "notification-id": "1c14106b-a18a-4890-9d47-a1a755ef5e47",
        "started": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z",
        "folderList": [
            "/"
        ]
    }
}

Nombres de los campos

Descripción

versión

Versión actual de la política de IAM.

id

ID que identifica la política de IAM.

tipo-detalle

Descripción del tipo de evento que inició la notificación que se envió.

origen

Servicio de AWS que es el origen de la solicitud y la notificación.

inscrita

ID de la cuenta de AWS donde se generaron la solicitud y la notificación.

hora

Fecha y hora en que se realizó la solicitud de actualización de los archivos del conjunto de trabajo.

region

Región de AWS desde la que se enviaron la solicitud y la notificación.

recursos

Recursos de Storage Gateway a los que se aplica la política.

event-type

Los Eventos de CloudWatch que iniciaron la notificación.

notification-id

ID generado de forma aleatoria de la notificación que se envió. Este ID tiene el formato UUID. Este es el ID de notificación que se devuelve cuando se llama a RefreshCache.

a

Fecha y hora en que la puerta de enlace recibió la solicitud RefreshCache y se inició la actualización.

completed

Fecha y hora en que finalizó la actualización del conjunto de trabajo.

folderList

Lista separada por comas de las rutas de las carpetas que se actualizaron en la caché. El valor predeterminado es ["/"].

Información acerca de las métricas de gateway

En la siguiente tabla se describen las métricas que cubren las puertas de enlace de archivo de S3. Cada puerta de enlace tiene un conjunto de métricas asociado. Algunas de las métricas específicas de puertas de enlace tienen el mismo nombre que determinadas métricas específicas de recursos compartidos de archivo. Estas métricas representan el mismo tipo de medidas, pero se asignan a la puerta de enlace en lugar de al recurso compartido de archivos.

Especifique siempre si desea trabajar con una puerta de enlace o un recurso compartido a la hora de trabajar con una métrica concreta. En concreto, cuando trabaje con métricas de puertas de enlace, debe especificar el Gateway Name de la puerta de enlace cuyos datos de métrica desee ver. Para obtener más información, consulte Uso de métricas de Amazon CloudWatch.

nota

Algunas métricas solo devuelven puntos de datos cuando se han generado nuevos datos durante el período de supervisión más reciente.

En la tabla siguiente se describen las métricas que puede utilizar para obtener información sobre la puerta de enlace de archivo de S3.

Métrica Descripción
AuditNotifications

Esta métrica indica el número de registros de auditoría emitidos.

Unidades: recuento
AvailabilityNotifications

Esta métrica indica el número de notificaciones de estado relacionadas con la disponibilidad que generó la puerta de enlace durante el período del informe.

Unidades: recuento
CacheFileSize

Esta métrica controla el tamaño de los archivos en la caché de la puerta de enlace.

Utilice esta métrica con la estadística Average para medir el tamaño medio de un archivo en la caché de la puerta de enlace. Utilice esta métrica con la estadística Max para medir el tamaño máximo de un archivo en la caché de la puerta de enlace.

Unidades: bytes
CacheFree

Esta métrica indica el número de bytes disponibles en la caché de la puerta de enlace.

Unidades: bytes
CacheHitPercent

Porcentaje de operaciones de lectura de la aplicación desde la puerta de enlace que se sirven desde la caché. La muestra se obtiene al final del período de notificación.

Cuando no hay operaciones de lectura de la aplicación desde la puerta de enlace, esta métrica registra un valor del 100 %.

Unidad: porcentaje
CachePercentDirty

Porcentaje total de memoria caché de la puerta de enlace que no se ha almacenado de forma persistente en AWS. La muestra se obtiene al final del período de notificación.

Utilice esta métrica con la estadística Sum.

Lo ideal es que esta métrica se mantenga baja.

Unidad: porcentaje
CachePercentUsed

Porcentaje de la caché de datos utilizada en toda la puerta de enlace. La muestra se obtiene al final del período de notificación.

Unidad: porcentaje
CacheUsed

Esta métrica indica el número de bytes utilizados en la caché de la puerta de enlace.

Unidades: bytes
CloudBytesDownloaded

Número total de bytes que la puerta de enlace ha descargado de AWS durante el período de notificación.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes
CloudBytesUploaded

Número total de bytes que la puerta de enlace ha cargado en AWS durante el periodo de notificación.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes
FilesFailingUpload

Esta métrica controla el número de archivos que no se pueden cargar en AWS. Estos archivos generarán notificaciones de estado que contienen más información sobre el problema.

Use esta métrica con la estadística Sum para mostrar el número de archivos que no se pueden cargar en AWS actualmente.

Unidades: recuento
FileSharesUnavailable

Esta métrica proporciona el número de recursos compartidos de archivos en estas puertas de enlace que se encuentran en el estado No disponible.

Si esta métrica indica que algún recurso compartido de archivos no está disponible, es probable que haya un problema con la puerta de enlace que pueda interrumpir el flujo de trabajo. Se recomienda crear una alarma para cuando esta métrica informe de un valor distinto de cero.

Unidades: recuento
FilesRenamed

Esta métrica controla el número de archivos a los que se ha cambiado el nombre en el período del informe.

Unidades: recuento
HealthNotifications

Esta métrica indica el número de notificaciones de estado que generó esta puerta de enlace en el período del informe.

Unidades: recuento
IndexEvictions

Esta métrica indica el número de archivos cuyos metadatos se han desalojado del índice almacenado en la caché de metadatos de archivos para dejar espacio para nuevas entradas. La puerta de enlace mantiene este índice de metadatos, que se rellena desde la nube de AWS.

Unidades: recuento
IndexFetches

Esta métrica indica el número de archivos para los que se han recuperado metadatos. La puerta de enlace mantiene un índice almacenado en caché de metadatos de archivos, que se rellena desde la nube de AWS bajo demanda.

Unidades: recuento
IoWaitPercent

Esta métrica indica el porcentaje de tiempo que la CPU está a la espera de recibir una respuesta del disco local.

Unidad: porcentaje
MemTotalBytes

Esta métrica indica la cantidad total de memoria de la puerta de enlace.

Unidades: bytes
MemUsedBytes

Esta métrica indica la cantidad de memoria utilizada en la puerta de enlace.

Unidades: bytes
NfsSessions

Esta métrica indica el número de sesiones NFS que están activas en la puerta de enlace.

Unidades: recuento
RootDiskFreeBytes

Esta métrica indica la cantidad de bytes disponibles en el disco raíz de la puerta de enlace.

Si esta métrica indica que quedan menos de 20 GB libres, debe aumentar el tamaño del disco raíz.

Para aumentar el tamaño del disco raíz, puede aumentar el tamaño del disco raíz existente en la máquina virtual. Cuando se reinicia la máquina virtual, la puerta de enlace reconoce el aumento de tamaño del disco raíz.

Unidades: bytes
S3GetObjectRequestTime

Esta métrica indica el tiempo que tarda la puerta de enlace en completar las solicitudes de obtención de objetos de S3.

Unidades: milisegundos
S3PutObjectRequestTime

Esta métrica indica el tiempo que tarda la puerta de enlace en completar las solicitudes de colocación de objetos de S3.

Unidades: milisegundos
S3UploadPartRequestTime

Esta métrica indica el tiempo que tarda la puerta de enlace en completar las solicitudes de carga de parte en S3.

Unidades: milisegundos
SmbV1Sessions

Esta métrica indica el número de sesiones de SMB versión 1 que están activas en la puerta de enlace.

Unidades: recuento
SmbV2Sessions

Esta métrica indica el número de sesiones de SMB versión 2 que están activas en la puerta de enlace.

Unidades: recuento
SmbV3Sessions

Esta métrica indica el número de sesiones de SMB versión 3 que están activas en la puerta de enlace.

Unidades: recuento
TotalCacheSize

Esta métrica indica el tamaño total de la caché.

Unidades: bytes
UserCpuPercent

Esta métrica indica el porcentaje de tiempo que se dedica al procesamiento de la puerta de enlace.

Unidad: porcentaje

Descripción de las métricas de recursos compartidos de archivos

A continuación puede encontrar información sobre las métricas de Storage Gateway que cubren recursos compartidos de archivos. Cada recurso compartido de archivos tiene un conjunto de métricas asociado. Algunas de las métricas específicas de los recursos compartidos tienen el mismo nombre que determinadas métricas específicas de gateways. Estas métricas representan el mismo tipo de medidas, pero se asignan al volumen en lugar de al recurso compartido de archivos.

Especifique siempre si desea trabajar con una métrica de gateway o de recurso compartido. En concreto, cuando trabaje con métricas de recurso compartido de archivos, debe especificar el valor de File share ID que identifique el recurso compartido de archivos cuyas métricas desea ver. Para obtener más información, consulte Uso de métricas de Amazon CloudWatch.

nota

Algunas métricas solo devuelven puntos de datos cuando se han generado nuevos datos durante el período de supervisión más reciente.

En la siguiente tabla se describen las métricas de Storage Gateway que puede utilizar para obtener información acerca de los recursos compartidos de archivos.

Métrica Descripción
CacheHitPercent

Porcentaje de operaciones de lectura de la aplicación desde los recursos compartidos de archivo que se sirven desde la caché. La muestra se obtiene al final del período de notificación.

Cuando no hay operaciones de lectura de la aplicación desde el recurso compartido de archivos, esta métrica registra un valor del 100 %.

Unidad: porcentaje
CachePercentDirty

La contribución del recurso compartido de archivos al porcentaje total de la caché de la puerta de enlace que no se ha almacenado de forma persistente en AWS. La muestra se obtiene al final del período de notificación.

Utilice esta métrica con la estadística Sum.

Lo ideal es que esta métrica se mantenga baja.

nota

Utilice la métrica CachePercentDirty de la puerta de enlace para ver el porcentaje total de la caché de la puerta de enlace que no se ha almacenado de forma persistente en AWS.

Unidad: porcentaje
CachePercentUsed

Porcentaje de la caché de datos utilizada en toda la puerta de enlace. La muestra se obtiene al final del período de notificación. Esta métrica específica del recurso compartido de archivos indica el mismo valor que la métrica específica de la puerta de enlace correspondiente.

Unidad: porcentaje
CloudBytesUploaded

Número total de bytes que la puerta de enlace ha cargado en AWS durante el periodo de notificación.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes
CloudBytesDownloaded

Número total de bytes que la puerta de enlace ha descargado de AWS durante el período de notificación.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes
FilesFailingUpload

Esta métrica controla el número de archivos que no se pueden cargar en AWS. Estos archivos generarán notificaciones de estado que contienen más información sobre el problema.

Use esta métrica con la estadística Sum para mostrar el número de archivos que no se pueden cargar en AWS actualmente.

Unidades: recuento
ReadBytes

El número total de bytes leídos desde las aplicaciones en las instalaciones en el período de notificación para un recurso compartido de archivos.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes
WriteBytes

El número total de bytes escritos en las aplicaciones on-premises en el período de notificación.

Utilice esta métrica con la estadística Sum para medir la velocidad y con la estadística Samples para medir las operaciones de entrada/salida por segundo (IOPS).

Unidades: bytes

Descripción de los registros de auditoría de la puerta de enlace de archivo de S3

Los registros de auditoría de la puerta de enlace de archivo de Amazon S3 (puerta de enlace de archivo de S3) proporcionan detalles sobre el acceso de los usuarios a archivos y carpetas dentro de un recurso compartido de archivos. Puede usarlos para supervisar las actividades de los usuarios y tomar medidas si se identifican patrones de actividad inapropiados.

Operaciones

En la tabla siguiente se describen las operaciones de acceso al archivo de registro de auditoría de la puerta de enlace de archivo de S3.

Nombre de operación

Definición

Leer datos

Leer el contenido de un archivo.

Escribir datos

Cambiar el contenido de un archivo.

Creación

Crear un nuevo archivo o carpeta.

Cambio de nombre

Cambiar el nombre de un archivo o carpeta existente.

Eliminar

Eliminar un archivo o carpeta.

Atributos de escritura

Actualizar metadatos de archivo o carpeta (ACL, propietario, grupo, permisos).

Atributos

En la tabla siguiente se describen los atributos de acceso al archivo de registro de auditoría de la puerta de enlace de archivo de S3.

Atributo

Definición
accessMode La configuración de permisos para el objeto.
accountDomain (Solo SMB) El dominio de Directorio Activo (AD) al que pertenece la cuenta del cliente.
accountName (solo SMB) Nombre de usuario de Active Directory del cliente.
bucket El nombre de bucket de S3.
clientGid (solo NFS) El identificador del grupo de usuarios que acceden al objeto.
clientUid (Solo NFS) El identificador del usuario que accede al objeto.
ctime Hora en la que se modificó el contenido o los metadatos del objeto, establecida por el cliente.
groupId El identificador del propietario de grupo del objeto.
fileSizeInBytes El tamaño del archivo en bytes, establecido por el cliente en el momento de la creación del archivo.
gateway El ID de Storage Gateway.
mtime El momento en el que el contenido del objeto fue modificado, establecido por el cliente.
newObjectName La ruta de acceso completa al nuevo objeto después de que se haya cambiado el nombre.
objectName La ruta completa al objeto.
objectType Define si el objeto es un archivo o una carpeta.
operation Nombre de la operación de acceso a objetos.
ownerId Identificador del propietario del objeto.
securityDescriptor (Solo SMB) Muestra la lista de control de acceso discrecional (DACL) establecida en un objeto, en formato SDDL.
shareName Nombre del recurso compartido al que se está accediendo.
source Identificador del recurso compartido de archivos que se está auditando.
sourceAddress La dirección IP del equipo cliente de recurso compartido de archivos.
status El estado de la operación. Solo se registra el éxito (los errores se registran con la excepción de los errores que surgen de permisos denegados).
timestamp Hora en la que se produjo la operación en función de la marca temporal del sistema operativo de la puerta de enlace.
version Versión del formato de registro de auditoría.

Atributos registrados por operación

En la tabla siguiente se describen los atributos de registro de auditoría de la puerta de enlace de archivo de S3 registrados en cada operación de acceso a archivos.

Leer datos

Escribir datos

Creación de una carpeta

Crear archivo

Cambiar nombre de archivo/carpeta

Eliminar archivo/carpeta

Atributos de escritura (cambiar ACL - solo SMB)

Atributos de escritura (chown)

Atributos de escritura (chmod)

Atributos de escritura (chgrp)
accessMode X X X
accountDomain (solo SMB) X X X X X X X X X X
accountName (solo SMB) X X X X X X X X X X
bucket X X X X X X X X X X
clientGid (solo NFS) X X X X X X X X X
clientUid (solo NFS) X X X X X X X X X
ctime X X
groupId X X
fileSizeInBytes X
gateway X X X X X X X X X X
mtime X X
newObjectName X
objectName X X X X X X X X X X
objectType X X X X X X X X X X
operation X X X X X X X X X X
ownerId X X X
securityDescriptor (solo SMB) X X
shareName X X X X X X X X X X
source X X X X X X X X X X
sourceAddress X X X X X X X X X X
status X X X X X X X X X X
timestamp X X X X X X X X X X
version X X X X X X X X X X