# Etiquetar recursos do Amazon CloudWatch
Uma *tag* é um rótulo de atributo personalizado que você ou a AWS atribui a um recurso da AWS.
As tags ajudam você a fazer o seguinte:
+ Identificar e organizar seus recursos da AWS. Diversos serviços da AWS são compatíveis com a marcação. É possível atribuir uma etiqueta semelhante a recursos de diferentes serviços para indicar que os recursos estão relacionados. Por exemplo, você pode atribuir a etiqueta que usou em uma regra do CloudWatch para uma instância do EC2.
As etiquetas são compostas por duas partes:
+ Uma *chave de tag* (por exemplo `CostCenter`, `Environment` ou `Project`). Chaves de tag fazem distinção entre maiúsculas e minúsculas.
+ Um campo opcional conhecido como um *valor de tag* (por exemplo, `111122223333` ou `Production`). Omitir o valor da tag é o mesmo que usar uma string vazia. Como chaves de tag, os valores das tags diferenciam maiúsculas de minúsculas.
As seções a seguir apresentam mais informações sobre etiquetas para o CloudWatch.
## Recursos compatíveis com o CloudWatch
Os recursos a seguir no CloudWatch permitem a marcação:
+ Alarmes: você pode marcar alarmes usando o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) da AWS CLI e a API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html). Também é possível visualizar e gerenciar suas tags de alarme usando a página de detalhes *Alarmes* no console do CloudWatch.
+ Canaries: é possível etiquetar canaries usando o console do CloudWatch. Para ter mais informações, consulte [Criar um canário](CloudWatch_Synthetics_Canaries_Create.md).
+ Regras do Contributor Insights: você pode marcar regras do Contributor Insights ao criá-las usando o comando [put-insight-rule](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-insight-rule.html) da AWS CLI e a API [PutInsightRule](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutInsightRule.html). Você pode adicionar tags a regras existentes usando o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) da AWS CLI e a API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html) .
+ Fluxos de métrica: é possível etiquetar fluxos de métrica ao criá-los usando o comando [put-metric-stream](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-stream.html) da AWS CLI e o comando[PutMetricStream](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricStream.html) da API. Você pode adicionar etiquetas a fluxos de métricas existentes usando o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html) da AWS CLI e a API [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html).
Para obter informações sobre como adicionar e gerenciar tags, consulte [Como gerenciar tags](#CloudWatch-tagging-add-edit-delete).
## Como gerenciar tags
As tags consistem nas propriedades `Value` e `Key` em um recurso. Você pode usar o console do CloudWatch, a AWS CLI ou a API do CloudWatch para adicionar, editar ou excluir os valores dessas propriedades. Para obter informações sobre como trabalhar com tags, consulte o seguinte:
+ [TagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html), [UntagResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html) e [ListTagsForResource](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListTagsForResource.html) na *Referência da API do Amazon CloudWatch*
+ [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/tag-resource.html), [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/untag-resource.html) e [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-tags-for-resource.html) na *Referência da CLI do Amazon CloudWatch*
+ [Trabalhar com o editor de tags](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) no *Manual do usuário do Resource Groups*
## Convenções de uso e nomenclatura de tags
As seguintes convenções básicas de uso e nomenclatura se aplicam ao uso de etiquetas com recursos do CloudWatch:
+ Cada recurso pode ter um máximo de 50 tags.
+ Em todos os recursos, cada chave de tag deve ser exclusiva e pode ter apenas um valor.
+ O comprimento máximo da chave da tag é de 128 caracteres Unicode em UTF-8.
+ O comprimento máximo do valor da tag é de 256 caracteres Unicode em UTF-8.
+ Os caracteres permitidos são letras, números, espaços representáveis em UTF-8, além dos seguintes caracteres: ***. : \$1 = @ \$1 / -*** (hífen).
+ As chaves e valores das tags diferenciam maiúsculas de minúsculas. Como melhor prática, decida-se sobre uma estratégia para letras maiúsculas em tags e implemente-a de forma consistente em todos os tipos de recursos. Por exemplo, decida se deseja usar `Costcenter`, `costcenter` ou `CostCenter` e use a mesma convenção para todas as tags. Evite usar tags semelhantes com tratamento do tamanho de letra inconsistente.
+ O prefixo `aws:` é proibido em tags, pois ele é reservado para uso pela AWS. Você não pode editar nem excluir chaves nem valores de tags com esse prefixo. As tags com esse prefixo não contam para as tags por limite de recurso.