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á-lo.

Métricas

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

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

Métricas suportadas 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 visualizar todas as colunas disponíveis.

Cabeçalhos de tabela

  • Categoria - O grupo ou classificação de métricas.
  • Métrica - O nome para exibição da métrica conforme aparece no portal do Azure.
  • Nome na API REST - O nome da métrica conforme referido na API REST.
  • Unidade - Unidade de medida.
  • Agregação - O tipo de agregação padrão. Valores válidos: Média (Média), Mínima (Mín), Máxima (Máx), Total (Soma), Contagem.
  • Dimensões - Dimensões disponíveis para a métrica.
  • Intervalos de grãos de - tempo 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.
  • DS Export- Se a métrica é exportável para os Logs do Azure Monitor por meio de configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Criar configurações de diagnóstico no Azure Monitor.
Métrica Nome na API REST Métricas avançadas de plataforma Unit Agregação Dimensões Grãos de tempo DS Exportação
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

Dados totais de saída transferidos do registo, 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 Milissegundos Total (soma) <nenhum> PT1M Sim
Armazenamento usado

A quantidade de armazenamento usada 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 extrações de imagem bem-sucedidas
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 tração

Número de imagens puxadas 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 da API do registo, segmentada por nome da API e tipo de resposta.
Transactions Não Count Total (soma) ApiName, ResponseType, Region PT1M Sim

Nota

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

Dimensões métricas

Para obter informações sobre o que são dimensões métricas, consulte Métricas multidimensionais.

Este serviço tem as seguintes dimensões associadas às suas métricas.

Nome da dimensão Description
ApiName A operação do registo representada pela métrica. Os valores disponíveis dependem da métrica.
ResponseType O resultado de uma transação, classificado pelo seu código de estado HTTP.
Region A região do Azure que tratava da transação ou de onde os dados eram transferidos.

Region Os valores dependem da região de origem do registo e das réplicas geográficas.

Nota

A StorageUsed métrica utiliza a dimensão legada Geolocation para representar a região do Azure onde o conteúdo é armazenado. Use Geolocation ao filtrar ou dividir StorageUsed. Métricas mais recentes usam a Region dimensão.

Valores de nomes API

A Transactions métrica suporta os seguintes ApiName valores:

  • HeadManifest: Verifica se existe um manifesto e recupera os seus cabeçalhos de resposta.
  • GetManifest: Recupera um manifesto.
  • GetManifestProperties: Recupera propriedades para um manifesto específico.
  • GetListManifests: Lista os manifestos num repositório.
  • GetTag: Recupera informações sobre uma etiqueta.
  • GetListTags: Lista as etiquetas num repositório.
  • HeadBlob: Verifica se existe um blob ou camada e recupera os seus cabeçalhos de resposta.
  • GetBlobRedirection: Redireciona um pedido de download de blob ou camada para a sua localização de conteúdo.
  • GetBlob: Recupera o conteúdo de blob ou camadas.
  • GetListRepositories: Lista repositórios no registo.
  • GetListReferrers: Lista artefactos que se referem a um determinado resumo do manifesto.
  • GetRepositoryProperties: Recupera propriedades do repositório.
  • GetToken: Solicita um token de acesso ACR para o âmbito solicitado.
  • PostToken: Troca um token de atualização ACR por um token de acesso ACR.
  • PostExchange: Troca um token de acesso Microsoft Entra por um token de atualização ACR.

Para as definições de API correspondentes, veja Grupos de operações REST do plano de dados do registo.

A DataTransfer métrica suporta os seguintes ApiName valores:

  • GetBlob: Dados transferidos quando um cliente descarrega um blob ou camada.
  • GetManifest: Dados transferidos quando um cliente recupera um manifesto.
  • GeoReplication: Dados transferidos durante a geo-replicação iniciada pelo serviço, incluindo sincronização inicial e replicação após um push.
  • ImportSource: Dados transferidos quando outro registo de contentores do Azure utiliza este registo como fonte de uma operação de importação.

Valores do tipo de resposta

A Transactions métrica suporta os seguintes ResponseType valores:

  • Success: A operação teve sucesso com o código de estado HTTP 200, 201 ou 202.
  • Redirect: A operação devolveu o código de estado HTTP 307. Por exemplo, um download de blob pode redirecionar o cliente para a localização de conteúdo do blob.
  • ClientErrorUnauthorized: A autenticação ou autorização falhou com o código de estado HTTP 401 ou 403.
  • ClientErrorNotFound: O recurso solicitado não foi encontrado e devolveu o código de estado HTTP 404.
  • Throttled: O pedido era limitado à taxa e devolveu o código de estado HTTP 429.
  • ClientErrorOther: A operação devolveu um erro de cliente 4xx que não tem um tipo de resposta dedicado.
  • ServerErrorOther: A operação devolveu um erro de servidor 5xx.

Registos do recurso

Esta seção lista os tipos de logs de recursos que você pode coletar para 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 suportados para Microsoft.ContainerRegistry/registries

Categoria Custos de exportação Tabela de registo Suporta plano de log básico Suporta a transformação do tempo de 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 do repositório do Registro de Contêiner do Azure

Não Sim Consultas

Tabelas de Logs do Azure Monitor

Esta seção lista as tabelas de Logs do Azure Monitor relevantes para este serviço, que estão disponíveis para consulta pelo Log Analytics usando consultas 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 todas as tabelas do Azure Monitor Logs e do Log Analytics, consulte a Referência da Tabela de Log 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 de nível de assinatura ou de grupo de gerenciamento que ocorreram no Azure.

  • AzureMetrics. Dados métricos emitidos pelos serviços do Azure que medem sua integridade e 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 a exclusão do repositório), purge tag e purge manifest.

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

Registo 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 possíveis do provedor de recursos no log de atividades.

Para obter mais informações sobre o esquema de entradas do log de atividades, consulte 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. Esta lista não é exaustiva.

Operation Description
Criar ou atualizar o registro de contêiner 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 login do Registro de contêiner Mostrar credenciais para a conta de administrador do registo
Importar Imagem Importar uma imagem ou outro artefacto para um registo
Criar atribuição de função Atribuir uma identidade a uma função RBAC (controle de acesso baseado em função) para acessar um recurso