Referência de dados de monitoramento do Registro de Contêiner do Azure

Este artigo contém todas as informações de referência de monitoramento para este serviço.

Consulte Monitorar o Registro de Contêiner do Azure para obter detalhes sobre os dados que você pode coletar para o Registro de Contêiner do Azure e como usá-los.

Métricas

Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas da plataforma com suporte no Azure Monitor.

Para obter informações sobre retenção de métricas, consulte Visão geral das métricas do Azure Monitor.

Métricas com suporte para Microsoft.ContainerRegistry/registries

A tabela a seguir lista as métricas disponíveis para o tipo de recurso Microsoft.ContainerRegistry/registries.

  • Nem todas as colunas podem estar presentes em todas as tabelas.
  • Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para exibir todas as colunas disponíveis.

Títulos de tabela

  • Categoria: o grupo ou classificação de métricas.
  • Métrica: o nome de exibição da métrica como aparece no portal do Azure.
  • Nome na API REST: o nome da métrica, conforme mencionado na API REST.
  • Unidade: unidade de medida
  • Agregação: o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
  • Dimensões: as - disponíveis para a métrica.
  • Intervalos de agregação: os - em que a métrica é amostrada. Por exemplo, PT1M indica que a métrica é amostrada a cada minuto, PT30M a cada 30 minutos, PT1H a cada hora e assim por diante.
  • Exportação de DS: se a métrica é exportável para os Logs do Azure Monitor via configurações de diagnóstico. Para obter mais informações sobre exportação de métricas, consulte as Criar configurações de diagnóstico no Azure Monitor.
Métrica Nome na API REST Métricas avançadas da plataforma Unidade Agregação Dimensões Granularidade de tempo Exportação de DS
Tempo de CPU do AgentPool

Tempo de CPU do AgentPool em segundos
AgentPoolCPUTime Não Segundos Total (Soma) <nenhum> PT1M Sim
Transferência de dados

Total de dados de saída transferidos do registro, medidos em bytes.
DataTransfer Não Bytes Total (Soma) ApiName, Region PT1M Sim
Duração da Execução

Duração da execução em milissegundos
RunDuration Não MilliSeconds Total (Soma) <nenhum> PT1M Sim
Armazenamento usado

A quantidade de armazenamento utilizada pelo registro de contêiner. Para uma conta de registro, é a soma da capacidade usada por todos os repositórios dentro de um registro. É a soma da capacidade usada por camadas compartilhadas, arquivos de manifesto e cópias de réplica em cada um de seus repositórios.
StorageUsed Não Bytes Média Geolocation PT1H Sim
Contagem de pull bem-sucedida

Número de pulls de imagem bem-sucedidos
SuccessfulPullCount Não Count Total (Soma) <nenhum> PT1M Sim
Contagem de push bem-sucedida

Número de pushes de imagem bem-sucedidos
SuccessfulPushCount Não Count Total (Soma) <nenhum> PT1M Sim
Contagem Total de Pull

Número de pulls de imagem no total
TotalPullCount Não Count Total (Soma) <nenhum> PT1M Sim
Contagem total de push

Número de pushes de imagem no total
TotalPushCount Não Count Total (Soma) <nenhum> PT1M Sim
Transações

Contagem de operações de API do Registro, segmentadas por nome de API e tipo de resposta.
Transactions Não Count Total (Soma) ApiName, ResponseType, Region PT1M Sim

Observação

Devido ao compartilhamento de camadas, o armazenamento do registro usado pode ser menor que a soma do armazenamento de repositórios individuais. Ao excluir um repositório ou marca, você recupera apenas o armazenamento usado pelos arquivos de manifesto e as camadas exclusivas referenciadas.

Dimensões de métrica

Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.

Este serviço tem as dimensões a seguir associadas a essas métricas.

Nome da dimensão Descrição
ApiName A operação do Registro representada pela métrica. Os valores disponíveis dependem da métrica.
ResponseType O resultado de uma transação, classificada por seu código de status HTTP.
Region O Azure região que manipulava a transação ou da qual os dados foram transferidos.

Region os valores dependem da região inicial do registro e das réplicas geográficas.

Observação

A StorageUsed métrica usa a dimensão herdada Geolocation para representar a região Azure em que o conteúdo é armazenado. Use Geolocation ao filtrar ou dividir StorageUsed. As métricas mais recentes usam a Region dimensão.

Valores de nome da API

A Transactions métrica dá suporte aos seguintes ApiName valores:

  • HeadManifest: verifica se um manifesto existe e recupera seus cabeçalhos de resposta.
  • GetManifest: recupera um manifesto.
  • GetManifestProperties: recupera as propriedades de um manifesto específico.
  • GetListManifests: lista os manifestos em um repositório.
  • GetTag: recupera informações sobre uma marca.
  • GetListTags: lista as marcas em um repositório.
  • HeadBlob: verifica se existe um blob ou camada e recupera seus cabeçalhos de resposta.
  • GetBlobRedirection: redireciona uma solicitação de download de blob ou camada para seu local de conteúdo.
  • GetBlob: recupera o conteúdo do blob ou da camada.
  • GetListRepositories: lista repositórios no registro.
  • GetListReferrers: lista artefatos que se referem a um resumo de manifesto especificado.
  • GetRepositoryProperties: recupera as propriedades do repositório.
  • GetToken: solicita um token de acesso do ACR para o escopo solicitado.
  • PostToken: troca um token de atualização do ACR por um token de acesso do ACR.
  • PostExchange: troca um token de acesso Microsoft Entra por um token de atualização do ACR.

Para obter as definições de API correspondentes, consulte grupos de operações REST do plano de dados do Registro.

A DataTransfer métrica dá suporte aos seguintes ApiName valores:

  • GetBlob: dados transferidos quando um cliente baixa um blob ou camada.
  • GetManifest: dados transferidos quando um cliente recupera um manifesto.
  • GeoReplication: dados transferidos durante a replicação geográfica iniciada pelo serviço, incluindo sincronização e replicação iniciais após um push.
  • ImportSource: dados transferidos quando outro registro de contêiner Azure usa esse registro como a origem de uma operação de importação.

Valores de tipo de resposta

A Transactions métrica dá suporte aos seguintes ResponseType valores:

  • Success: a operação foi bem-sucedida com o código de status HTTP 200, 201 ou 202.
  • Redirect: a operação retornou o código de status HTTP 307. Por exemplo, um download de blob pode redirecionar o cliente para o local de conteúdo do blob.
  • ClientErrorUnauthorized: falha na autenticação ou autorização com o código de status HTTP 401 ou 403.
  • ClientErrorNotFound: o recurso solicitado não foi encontrado e retornou o código de status HTTP 404.
  • Throttled: a solicitação foi limitada por taxa e retornou o código de status HTTP 429.
  • ClientErrorOther: a operação retornou um erro de cliente 4xx que não tem um tipo de resposta dedicado.
  • ServerErrorOther: a operação retornou um erro de servidor 5xx.

Logs de recursos

Esta seção lista os tipos de logs de recursos que você pode coletar para o este serviço. A seção extrai da lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.

Logs de recursos com suporte para Microsoft.ContainerRegistry/registries

Categoria Custos de exportação Tabela de log Com suporte a plano de log básico Com suporte a transformações de tempo-ingestão Consultas de exemplo
ContainerRegistryLoginEvents Não ContainerRegistryLoginEvents

Logs de auditoria de logon do Registro de Contêiner do Azure

Não Sim Consultas
ContainerRegistryRepositoryEvents Não ContainerRegistryRepositoryEvents

Logs de auditoria de repositório do Registro de Contêiner do Azure

Não Sim Consultas

Tabelas de Logs do Azure Monitor

Esta seção lista todas as tabelas dos Logs do Azure Monitor relevantes para este serviço e disponíveis para consulta pela análise de logs usando o Kusto. As tabelas contêm dados de log de recursos e possivelmente mais, dependendo do que é coletado e roteado para elas.

Para obter uma referência de todos os Logs do Azure Monitor e tabelas do Log Analytics, consulte a Referência da Tabela de Logs do Azure Monitor.

Registro de contêiner Microsoft.ContainerRegistry/registries

  • AzureActivity. Entradas do log de atividades do Azure que fornecem informações sobre quaisquer eventos no nível da assinatura ou no nível do grupo de gerenciamento que ocorreram no Azure.

  • AzureMetrics. Os dados de métrica emitidos pelos serviços do Azure que medem a integridade e o desempenho.

  • ContainerRegistryLoginEvents. Eventos e status de autenticação do Registro, incluindo a identidade de entrada e o endereço IP.

  • ContainerRegistryRepositoryEvents. Operações em imagens e outros artefatos em repositórios de registro. As seguintes operações são registradas: push, pull, untag, delete (incluindo exclusão de repositório), purge tag e purge manifest.

    Os eventos de limpeza serão registrados somente se uma política de retenção do registro estiver configurada.

Log de atividades

A tabela vinculada lista as operações que podem ser registradas no log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.

Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.

A tabela a seguir lista as operações relacionadas ao Registro de Contêiner do Azure que podem ser criadas no log de atividades. Essa lista não é completa.

Operação Descrição
Criar ou Atualizar Registro de Contêineres Criar um registro de contêiner ou atualizar uma propriedade do registro
Excluir Registro de Contêiner Excluir um registro de contêiner
Listar credenciais de logon do Registro de Contêiner Mostrar credenciais para a conta de administrador do registro
Importar imagem Importar uma imagem ou outro artefato para um registro
Criar Atribuição de Função Atribuir a uma identidade uma função de controle de acesso baseado em função (RBAC) para acessar um recurso