Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso - Amazon Simple Storage Service

Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso

Existen tres tipos de métricas de Amazon CloudWatch para Amazon S3: métricas de almacenamiento, métricas de solicitud y métricas de replicación. Las métricas de almacenamiento se informan una vez al día y se entregan a todos los clientes sin costo adicional. Las métricas de solicitudes están disponibles en intervalos de un minuto después de un breve periodo de latencia para procesarlas. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Debe incluir métricas de solicitudes configurándolas en la consola o con la API de Amazon S3. Las métricas de replicación de S3 proporcionan métricas detalladas para las reglas de replicación en la configuración de la misma. Con las métricas de replicación, puede monitorizar su progreso minuto a minuto mediante el seguimiento de los bytes pendientes, las operaciones que no se han replicado y la latencia de replicación.

Para obtener más información acerca de las métricas de CloudWatch para Amazon S3, consulte Monitorización de métricas con Amazon CloudWatch.

Cuando configura las métricas de CloudWatch, puede crear un filtro para todos los objetos del bucket o puede filtrar la configuración en grupos de objetos relacionados dentro de un solo bucket. Puede filtrar los objetos de un bucket para incluirlos en una configuración de métricas en función de uno o varios de los siguientes tipos de filtro:

  • Prefijo de nombre de clave de objeto: aunque el modelo de datos de Amazon S3 es una estructura plana, puede inferir la jerarquía con un prefijo. La consola de Amazon S3 admite estos prefijos con el concepto de carpetas. Si filtra por prefijo, los objetos que tengan el mismo prefijo se incluyen en la configuración de métricas. Para obtener más información acerca de los prefijos, consulte Organizar objetos con prefijos.

  • Etiqueta: puede añadir etiquetas, que son pares de nombre de clave-valor, a los objetos. Las etiquetas le permiten encontrar y organizar los objetos fácilmente. También puede utilizar las etiquetas como filtro para las configuraciones de métricas. Para obtener más información acerca de las etiquetas de objeto, consulte Categorización del almacenamiento mediante etiquetas.

  • Punto de acceso: los puntos de acceso de S3 se denominan puntos de enlace de red que se adjunta a los buckets y simplifican la administración del acceso a los datos a escala para los conjuntos de datos compartidos en S3. Cuando crea un filtro de punto de acceso, Amazon S3 incluye solicitudes al punto de acceso que especifique en la configuración de métricas. Para obtener más información, consulte Monitorización y registro de puntos de acceso.

    nota

    Al crear una configuración de métricas que filtra por punto de acceso, debe utilizar el Nombre de recurso de Amazon (ARN) del punto de acceso, no el alias del punto de acceso. Asegúrese de utilizar el ARN para el punto de acceso en sí, no el ARN para un objeto específico. Para obtener más información acerca de los ARN de puntos de acceso, consulte Usar puntos de acceso.

Si especifica un filtro, únicamente las solicitudes que operen en objetos únicos pueden coincidir con el filtro e incluirse entre las métricas de las que se informa. Las solicitudes como DeleteObjects y ListObjects no devuelven métricas para las configuraciones con filtros.

Para solicitar un filtrado más complejo, seleccione dos o más elementos. Solo los objetos que tengan todos estos elementos se incluirán en la configuración de métricas. Si no configura filtros, todos los objetos del bucket se incluirán en la configuración de métricas.

  1. Inicie sesión AWS Management Console Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. En la lista Buckets, elija el nombre del bucket que contiene los objetos para los que desea obtener métricas de solicitudes.

  3. Elija la pestaña Metrics (Métricas).

  4. En Bucket metrics (Métricas de bucket), seleccione View additional charts (Ver gráficos adicionales).

  5. Seleccione la pestaña Request metrics (Métricas de solicitud).

  6. Elija Create Filter (Crear filtro).

  7. En el cuadro Filter name (Nombre del filtro), escriba el nombre del filtro.

    Los nombres solo pueden incluir letras, números, puntos, guiones y guiones bajos.

  8. En Filter scope (Alcance del filtro), elija Limit the scope of this filter using a prefix, object tags, and an S3 Access Point, or a combination of all three (Limitar el alcance de este filtro usando un prefijo, etiquetas de objeto y un Punto de acceso de S3, o una combinación de las tres).

  9. En Filter type (Tipo de filtro), elija al menos un tipo de filtro: Prefix (Prefijo), Object tags (Etiquetas de objeto) o Access Point (Punto de acceso).

  10. Para definir un filtro de prefijo y limitar el alcance del filtro a una ruta individual, en el cuadro Prefix (Prefijo), ingrese un prefijo.

  11. Para definir un filtro de etiquetas de objeto, en Object tags (Etiquetas de objeto), elija Add tag (Agregar etiqueta) y, luego, ingrese una etiqueta Key (Clave) y Value (Valor).

  12. Para definir un filtro de punto de acceso, en el campo Punto de acceso de S3, introduzca el ARN del punto de acceso o elija Examinar S3 para desplazarse hasta el punto de acceso.

    importante

    No se puede introducir un alias de punto de acceso. Debe introducir el ARN para el punto de acceso en sí, no el ARN para un objeto específico.

  13. Elija Guardar cambios.

    Amazon S3 crea un filtro que usa el prefijo, etiquetas o punto de acceso especificados.

  14. En la pestaña Request metrics (Métricas de solicitud), bajo Filters (Filtros), elija el filtro que acaba de crear.

    Ahora ha creado un filtro que limita el alcance de las métricas de solicitud por prefijo, etiquetas de objeto o punto de acceso. Aproximadamente 15 minutos después de que CloudWatch comience a realizar el seguimiento de estas métricas de solicitudes, puede ver gráficos para las métricas en las consolas de Amazon S3 y CloudWatch. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Para obtener más información, consulte los precios de Amazon CloudWatch.

    También puede configurar métricas de solicitud en el nivel de bucket. Para obtener más información, consulte Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket.

  1. Instale y configure la AWS CLI. Para obtener instrucciones, consulte Instalación, actualización y desinstalación de la AWS CLI en la Guía del usuario de AWS Command Line Interface.

  2. Abra un terminal.

  3. Ejecute uno de los siguientes comandos para agregar una configuración de métricas:

    ejemplo : para filtrar por prefijo
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
    ejemplo : para filtrar por etiquetas
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
    ejemplo : para filtrar por punto de acceso
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
    ejemplo : para filtrar por prefijo, etiquetas y punto de acceso
    aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '
{
    "Id": "metrics-config-id",
    "Filter": {
        "And": {
            "Prefix": "string",
            "Tags": [
                {
                    "Key": "string",
                    "Value": "string"
                }
            ],
            "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
        }
    }
}'

También puede añadir configuraciones de métricas mediante programación con la API de REST de Amazon S3. Para obtener más información acerca de cómo agregar y trabajar con configuraciones de métricas, consulte los siguientes temas en la Referencia de API de Amazon Simple Storage Service: