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,EnvironmentouProject). Chaves de tag fazem distinção entre maiúsculas e minúsculas. -
Um campo opcional conhecido como um valor de tag (por exemplo,
111122223333ouProduction). 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 da AWS CLI e a API TagResource. 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.
-
Regras do Contributor Insights: você pode marcar regras do Contributor Insights ao criá-las usando o comando put-insight-rule da AWS CLI e a API PutInsightRule. Você pode adicionar tags a regras existentes usando o comando tag-resource da AWS CLI e a API TagResource .
-
Fluxos de métrica: é possível etiquetar fluxos de métrica ao criá-los usando o comando put-metric-stream da AWS CLI e o comandoPutMetricStream da API. Você pode adicionar etiquetas a fluxos de métricas existentes usando o comando tag-resource da AWS CLI e a API TagResource.
Para obter informações sobre como adicionar e gerenciar tags, consulte Como gerenciar tags.
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, UntagResource e ListTagsForResource na Referência da API do Amazon CloudWatch
-
tag-resource, untag-resource e list-tags-for-resource na Referência da CLI do Amazon CloudWatch
-
Trabalhar com o editor de tags 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: . : + = @ _ / - (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,costcenterouCostCentere 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.
