Etiquetado de reglas de muestreo y grupos de X-Ray - AWS X-Ray
Restricciones de las etiquetasAdministración de etiquetas en la consolaAdministración de etiquetas en la AWS CLIControlar el acceso a los recursos de X-Ray en función de etiquetas

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.

Etiquetado de reglas de muestreo y grupos de X-Ray

Las etiquetas son palabras o frases que puede utilizar para identificar y organizar sus recursos de AWS. Puede agregar varias etiquetas a cada recurso. Cada etiqueta incluye una clave y un valor opcional que define el usuario. Por ejemplo, la clave de etiqueta podría ser domain y el valor de etiqueta podría ser example.com. Puede buscar y filtrar sus recursos en función de las etiquetas que añada. Para más información sobre el uso de etiquetas, consulte Etiquetado de recursos de AWS en la Guía de referencia general de AWS.

Puede utilizar etiquetas para aplicar permisos basados en etiquetas a las distribuciones de CloudFront. Para obtener más información, consulte Control de acceso a los recursos de AWS mediante etiquetas.

nota

Actualmente, ni Tag Editor ni AWS Resource Groups admiten recursos de X-Ray. Las etiquetas se agregan y administran mediante la consola o la API de AWS X-Ray.

También puede aplicar etiquetas a recursos a través de la consola, la API y los SDK de X-Ray, la AWS CLI y AWS Tools for Windows PowerShell. Para obtener más información, consulte la documentación siguiente:

nota

Si no puede agregar o cambiar etiquetas en un recurso de X-Ray, o no puede agregar un recurso que tenga etiquetas específicas, es posible que no tenga permisos para realizar esta operación. Para solicitar acceso, póngase en contacto con un usuario de AWS de su empresa que tenga permisos de administrador en X-Ray.

Restricciones de las etiquetas

Se aplican las siguientes restricciones a las etiquetas.

  • Número máximo de etiquetas por recurso: 50

  • Longitud máxima de la clave: 128 caracteres Unicode.

  • Longitud máxima del valor: 256 caracteres Unicode.

  • Valores válidos para claves y valores: a-z, A-Z, 0-9, espacio y los siguientes caracteres: _ . : / = + - y @

  • Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

  • No utilice aws: como prefijo para claves, ya que está reservado para AWS.

nota

No puede editar ni eliminar las etiquetas del sistema.

Administración de etiquetas en la consola

Puede añadir etiquetas opcionales al crear un grupo de X-Ray o una regla de muestreo. Las etiquetas también se pueden cambiar o eliminar en la consola más adelante.

En los siguientes procedimientos se explica cómo agregar, editar y eliminar etiquetas para sus grupos y reglas de muestreo en la consola X-Ray.

Agregar etiquetas a un nuevo grupo (consola)

Al crear un nuevo grupo de X-Ray, puede añadir etiquetas opcionales en la página Crear grupo.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de X-Ray en https://console.aws.amazon.com/xray/home.

  2. En el panel de navegación, expanda Configuración y elija Grupos.

  3. Elija Crear grupo.

  4. En la página Crear grupo, especifique un nombre y una expresión de filtro para el grupo. Para obtener más información sobre estas propiedades, consulte Configuración de grupos.

  5. En Etiquetas, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de Stage y un valor de etiqueta de Production para indicar que este grupo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  6. Cuando termine de agregar etiquetas, elija Crear grupo.

Agregar etiquetas a una nueva regla de muestreo (consola)

Al crear una nueva regla de muestreo de X-Ray, puede añadir etiquetas en la página Crear regla de muestreo.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de X-Ray en https://console.aws.amazon.com/xray/home.

  2. En el panel de navegación, expanda Configuración y elija Muestreo.

  3. Seleccione Crear regla de muestreo.

  4. En la página Crear regla de muestreo, especifique el nombre, la prioridad, los límites, los criterios coincidentes y los atributos coincidentes. Para obtener más información sobre estas propiedades, consulte Configuración de reglas de muestreo de .

  5. En Etiquetas, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de Stage y un valor de etiqueta de Production para indicar que esta regla de muestreo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  6. Cuando termine de agregar etiquetas, elija Crear regla de muestreo.

Edición o eliminación de etiquetas de un grupo (consola)

Puede cambiar o eliminar etiquetas de un grupo de X-Ray en la página Editar grupo.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de X-Ray en https://console.aws.amazon.com/xray/home.

  2. En el panel de navegación, expanda Configuración y elija Grupos.

  3. En la tabla Grupos, elija el nombre del un grupo.

  4. En la página Editar grupo, en Etiquetas, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página Editar grupo, consulte Configuración de grupos. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  5. Para eliminar una etiqueta, elija X a la derecha de la etiqueta.

  6. Cuando haya terminado de editar o eliminar etiquetas, elija Actualizar grupo.

Edición o eliminación de etiquetas de una regla de muestreo (consola)

Puede cambiar o eliminar las etiquetas de una regla de muestreo de X-Ray en la página Editar regla de muestreo.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de X-Ray en https://console.aws.amazon.com/xray/home.

  2. En el panel de navegación, expanda Configuración y elija Muestreo.

  3. En la tabla Reglas de muestreo, elija el nombre de una regla de muestreo.

  4. En Etiquetas, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página Editar regla de muestreo, consulte Configuración de reglas de muestreo de . Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  5. Para eliminar una etiqueta, elija X a la derecha de la etiqueta.

  6. Cuando haya terminado de editar o eliminar etiquetas, elija Actualizar regla de muestreo.

Administración de etiquetas en la AWS CLI

Puede añadir etiquetas al crear un grupo o una regla de muestreo de X-Ray. También puede utilizar la AWS CLI para crear y administrar etiquetas. Para actualizar las etiquetas de un grupo o de una regla de muestreo existente, use la consola de AWS X-Ray o las API TagResource o UntagResource.

Agregar etiquetas a un nuevo grupo de o regla de muestreo de X-Ray (CLI)

Para añadir etiquetas opcionales al crear un nuevo grupo o una nueva regla de muestreo de X-Ray, utilice uno de los siguientes comandos.

  • Para añadir etiquetas a un nuevo grupo, ejecute el siguiente comando y sustituya group_name por el nombre de su grupo, mydomain.com por el punto de conexión de su servicio, key_name por una clave de etiqueta y, si lo desea, value por un valor de etiqueta. Para obtener más información sobre cómo crear un grupo, consulte Grupos.

    aws xray create-group \
   --group-name "group_name" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

    A continuación se muestra un ejemplo.

    aws xray create-group \
   --group-name "AdminGroup" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

  • Para añadir etiquetas a una nueva regla de muestreo, ejecute el siguiente comando y sustituya key_name por una clave de etiqueta y, si lo desea, value por un valor de etiqueta. Este comando especifica los valores del parámetro --sampling-rule como archivo JSON. Para obtener más información sobre cómo crear una regla de muestreo, consulte Reglas de muestreo.

    aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

    A continuación puede ver el contenido del archivo JSON file_name.json especificado por el parámetro --cli-input-json.

    {
    "SamplingRule": {
        "RuleName": "rule_name",
        "RuleARN": "string",
        "ResourceARN": "string",
        "Priority": integer,
        "FixedRate": double,
        "ReservoirSize": integer,
        "ServiceName": "string",
        "ServiceType": "string",
        "Host": "string",
        "HTTPMethod": "string",
        "URLPath": "string",
        "Version": integer,
        "Attributes": {"attribute_name": "value","attribute_name": "value"...}
    }
    "Tags": [
           {
               "Key":"key_name",
               "Value":"value"
           },
           {
               "Key":"key_name",
               "Value":"value"
           }
          ]
}

    El siguiente comando es un ejemplo.

    aws xray create-sampling-rule \
   --cli-input-json file://9000-base-scorekeep.json

    A continuación puede ver el contenido del archivo de ejemplo 9000-base-scorekeep.json especificado por el parámetro --cli-input-json.

    {
    "SamplingRule": {
        "RuleName": "base-scorekeep",
        "ResourceARN": "*",
        "Priority": 9000,
        "FixedRate": 0.1,
        "ReservoirSize": 5,
        "ServiceName": "Scorekeep",
        "ServiceType": "*",
        "Host": "*",
        "HTTPMethod": "*",
        "URLPath": "*",
        "Version": 1
    }
    "Tags": [
           {
               "Key":"Stage",
               "Value":"Prod"
           },
           {
               "Key":"Department",
               "Value":"QA"
           }
          ]
}

Añadir etiquetas a un recurso existente (CLI)

Puede ejecutar el comando tag-resource para añadir etiquetas a un grupo o una regla de muestreo de X-Ray existente. Este método puede resultar más sencillo que añadir etiquetas ejecutando update-group o update-sampling-rule.

Para agregar etiquetas a un grupo o a una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves y los valores opcionales de las etiquetas que desee agregar.

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

A continuación se muestra un ejemplo.

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

Visualizar las etiquetas de un recurso (CLI)

Puede ejecutar el comando list-tags-for-resource para ver una lista de las etiquetas de un grupo o una regla de muestreo de X-Ray.

Para ver una lista de las etiquetas asociadas a un grupo o una regla de muestreo, ejecute el siguiente comando sustituyendo el ARN por el ARN del recurso.

aws xray list-tags-for-resource \
   --resource-arn "ARN"

A continuación se muestra un ejemplo.

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

Eliminar etiquetas de un recurso (CLI)

Puede ejecutar el comando untag-resource para eliminar las etiquetas de un grupo o una regla de muestreo de X-Ray.

Para agregar etiquetas de un grupo o de una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves de las etiquetas que desee eliminar.

Con el comando untag-resource solo puede eliminar etiquetas enteras. Para eliminar los valores de las etiquetas, utilice la consola de X-Ray o elimine las etiquetas y añada otras nuevas con las mismas claves pero con valores diferentes o vacíos.

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

A continuación se muestra un ejemplo.

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

Controlar el acceso a los recursos de X-Ray en función de etiquetas

Puede adjuntar etiquetas a los grupos o las reglas de muestreo de X-Ray, o pasar las etiquetas en una solicitud a X-Ray. Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición xray:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys. Para obtener más información sobre estas claves de condición, consulte Control de acceso a los recursos de AWS mediante etiquetas.

Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte Gestión del acceso a los grupos de rayos X y a las reglas de muestreo en función de las etiquetas.