Lar/Documentos
Configuração de extensão
Ext Ops Panel é um painel de controle para suas próprias extensões Chrome (MV3). Você conecte uma extensão em dois lugares: pixels hospedados que relatam o ciclo de vida eventos e um endpoint de métricas opcional que seu serviço expõe para personalização métricas. Esta página é o mapa; cada área tem seu próprio guia.
O que fica conectado
1. Pixels do ciclo de vida (ingestão)
Contagens de instalação, desinstalação e reinstalação (devolução), além do motivo da desinstalação feedback, flua das páginas hospedadas de boas-vindas e desinstalação que você aponta para seu extensão em. O próprio serviço de análise da sua extensão encaminha esses eventos para os pontos finais de ingestão do painel; o registro local continua sendo sua fonte de verdade e o painel recebe apenas contagens agregadas. Isso produz a primeira parte métricas básicas (instalações/desinstalações/reinstalações/feedback/Chrome Web Store health) que aparecem antes mesmo de você adicionar qualquer métrica personalizada.
Integração de uma extensão existente (pixels de boas-vindas/desinstalação, formulário de feedback e o redirecionamento de reinstalação) é um manual do operador em vez de um API público que você conecte manualmente, para que as cargas exatas acompanhem o fluxo de integração. O costume O contrato de métricas abaixo é a parte que você mesmo implementa.
2. Métricas personalizadas (orientadas por metadados)
Além das métricas básicas, o serviço da sua extensão pode expor uma única métrica ponto final que o painel puxa. Cada métrica carrega sua própria apresentação: onde e como mostrá-lo no painel (guias, seções, tipo de renderização) e no Status Telegram (linha, posição, formato). O painel é um renderizador genérico, então você nunca codifica uma tela ou uma mensagem de bot do nosso lado. Este é o contrato documentado e formal.
3. Monitoramento (pulsação push + pings de tempo de atividade)
O monitoramento coloca um ramal sob vigilância constante: um agente no seu serviço host envia relatórios de pulsação (relatórios perdidos escalam um semáforo no placa de extensão) e o próprio painel faz ping em seus URLs públicos para disponibilidade. Uma mensagem de status Telegram separada e alertas de borda reagem a cada mudança de cor.
Contrato de métricas personalizadas ->
O endpoint de métricas que seu serviço implementa e o painel extrai: carga útil, auth, tipos, tipos de renderização, modelos Telegram e o arquivo OpenAPI.
OpenAPI (YAML) ↓
Descrição OpenAPI 3.1 legível por máquina do endpoint de métricas de origem. Importe-o para seu ferramental ou codegen.
Contrato de monitoramento ->
Relatórios de pulsação com watchdog, pings de tempo de atividade e tráfego agregado light, alertas Telegram e o arquivo de monitoramento OpenAPI.
Monitoramento OpenAPI (YAML) ↓
Descrição legível por máquina OpenAPI 3.1 do relatório de monitoramento endpoint que o painel implementa e seu agente chama.