Monitorização#

A Ultralytics Platform fornece monitorização para endpoints implementados. Acompanha as métricas dos pedidos, consulta os registos e verifica o estado de funcionamento com sondagem automática.

Painel de implementações#

A página Deploy na barra lateral funciona como painel de monitorização de todas as tuas implementações. Combina o mapa-múndi, as métricas de visão geral e a gestão de implementações numa única vista. Consulta Dedicated Endpoints para criar e gerir implementações.

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per Ready Deployment"
        Metrics[Metrics Row]:::out
        Health[Health Check]:::out
        Logs[Logs Tab]:::out
        Code[Code Tab]:::out
        Predict[Predict Tab]:::out
    end
    List --> Metrics
    List --> Health
    List --> Logs
    List --> Code
    List --> Predict

    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

Cartões de visão geral#

Os quatro cartões de resumo no topo da página mostram:

É comunicada a latência P95, em vez da latência mediana, porque as verificações de funcionamento demoram alguns milissegundos e, caso contrário, dominariam a representação da latência real de inferência.

Mapa-múndi#

O mapa-múndi interativo mostra:

• Marcadores de região para todas as 42 regiões disponíveis
• Marcadores verdes para regiões com uma implementação pronta
• Marcadores azuis animados para regiões com implementações ativas em curso
• O tamanho do marcador varia consoante o estado da implementação e a latência

Clica em qualquer região para abrir a caixa de diálogo New Deployment. O mapa fica oculto em ecrãs pequenos.

Lista de implementações#

Abaixo dos cartões de visão geral, a lista de implementações mostra todos os endpoints dos teus projetos. Usa o seletor do modo de visualização para alternar entre:

Métricas por implementação#

Cada cartão de implementação (na vista de cartões) mostra métricas em tempo real. A linha de métricas, a verificação de funcionamento e os separadores Logs, Code e Predict descritos abaixo aparecem apenas enquanto a implementação estiver Ready:

Linha de métricas#

As métricas são atualizadas automaticamente. Os endpoints que ainda não processaram nenhum pedido mostram "Ainda sem tráfego" e as métricas só são recolhidas para implementações no estado Ready. No painel de implementações, as métricas são obtidas para as 20 implementações mais recentes.

Verificação de integridade#

As implementações em execução mostram um indicador de verificação de funcionamento:

As verificações de funcionamento são repetidas automaticamente enquanto o endpoint não está saudável e param assim que o endpoint responde. Clica no ícone de atualização para acionar manualmente uma verificação de funcionamento, que também funciona como forma de aquecer um endpoint reduzido a zero antes de enviar tráfego.

Registos#

Cada cartão de implementação inclui um separador Logs para consultar as entradas de registo recentes:

Entradas de registo#

Cada entrada de registo mostra:

A interface mostra as 20 entradas mais recentes e oculta as vazias. Por predefinição, a API devolve 50 entradas por pedido (máximo de 200) e retorna um nextPageToken para paginar mais para trás.

Exemplos de código#

Cada cartão de implementação inclui um separador Code que mostra código de API pronto a utilizar, com o URL do endpoint preenchido. Para os proprietários do workspace, a chave de API associada à implementação é inserida, pronta para copiar e executar. Os não proprietários veem um marcador de posição YOUR_API_KEY:

import requests

# Deployment endpoint
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

Previsão da implementação#

O separador Predict em cada cartão de implementação fornece um painel de previsão integrado — a mesma interface do separador Predict do modelo, mas executando a inferência através do endpoint de implementação em vez do serviço partilhado. Isto é útil para testar um endpoint implementado diretamente a partir do navegador. Consulta Inferência para obter detalhes sobre os parâmetros e os formatos das respostas.

Endpoints da API#

Cada implementação é identificada pelo seu proprietário e nome, e cada rota requer uma chave de API. Consulta a referência da API para obter detalhes sobre a autenticação.

Métricas da implementação#

GET /api/deployments/{owner}/{deployment}/metrics?range=24h

SDK Python: client.deployments.metrics(owner, deployment, range="24h")

Devolve o payload completo de métricas de uma implementação: um bloco summary com o total de pedidos, a contagem e a taxa de erros e as latências média, P50, P95 e P99, além de matrizes timeSeries para pedidos, erros e latências P50 e P95, utilização de CPU e memória e contagem de instâncias.

Com sparkline=true, a resposta apresenta o formato compacto utilizado pelos cartões de implementação — 24 contagens horárias de pedidos, além do total de pedidos, da taxa de erros e da latência média. Esta é a chamada que é atualizada a cada 60 segundos.

Registos da implementação#

GET /api/deployments/{owner}/{deployment}/logs?limit=50&severity=ERROR,WARNING

SDK Python: client.deployments.logs(owner, deployment, limit=50, severity="ERROR,WARNING")

Devolve entradas de registo recentes com filtro de gravidade e paginação opcionais.

Estado da implementação#

GET /api/deployments/{owner}/{deployment}/health

SDK Python: client.deployments.health(owner, deployment)

Faz ping à implementação e devolve o respetivo estado de funcionamento com a latência de ida e volta medida:

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142
}

Uma resposta de estado não saudável omite status quando não foi possível alcançar o endpoint, e adiciona uma mensagem error.

Otimização do desempenho#

Utiliza os dados de monitorização para otimizar as tuas implementações:

Perguntas frequentes#