Log drain do Supabase e logs de Edge Functions com o LogBrew

Você pode enviar 2 tipos de dados do Supabase para o LogBrew:

Um log drain envia os logs da plataforma do seu projeto Supabase, como os logs de Postgres, Auth, Storage e Edge Functions.
O SDK de JavaScript do LogBrew envia os logs e erros que o código das suas Edge Functions captura.

Você pode usar um dos dois ou ambos. Os dois precisam de uma chave de ingestão do projeto. Crie uma chave server para cada uso. Os tipos de chave estão em Tipos de chave de projeto.

Envie logs da plataforma com um log drain

Os log drains do Supabase estão disponíveis nos planos Pro, Team e Enterprise do Supabase. O Supabase cobra por drain e pelos eventos que cada drain envia. Leia os preços do Supabase antes de adicionar um drain.

Abra as configurações de log drain

No painel do Supabase, abra o seu projeto. Vá para Project Settings e depois para Log Drains.

Adicione um destino OpenTelemetry

Adicione um destino do tipo OpenTelemetry (OTLP). Defina estes valores:

Campo	Valor
Endpoint	`https://api.logbrew.co/v1/logs`
Protocol	`http/protobuf`
Gzip	On
Headers	`x-logbrew-key` com a sua chave de ingestão como valor

Em vez de x-logbrew-key, você pode usar o cabeçalho Authorization com o valor Bearer lbw_ingest_....

Salve o destino

Salve o destino. O Supabase começa a enviar logs para o LogBrew.Ponto de controle: novos logs do Supabase aparecem nos logs do seu projeto LogBrew. Para ler esses logs pela CLI, siga Leia de volta o seu evento de teste.

O LogBrew lê o drain como logs OTLP. O atributo de recurso service.name define o serviço de cada log. Os outros atributos de recurso ficam nos metadados do log. O LogBrew remove credenciais das URLs e de atributos como authorization antes de armazenar o log. O mapeamento completo está no guia OpenTelemetry (OTLP). Se nenhum log chegar, confira o endpoint, o protocolo e o cabeçalho. A chave de ingestão precisa pertencer ao projeto LogBrew que você lê.

Capture logs e erros em Edge Functions

As Edge Functions do Supabase rodam no Deno. Use o @logbrew/node do npm. Esta configuração funciona com Deno 2.9, @logbrew/node 0.1.20 e @logbrew/sdk 0.1.35.

Salve a chave de ingestão como segredo da função

Use a CLI do Supabase. Substitua o marcador pela sua chave:

supabase secrets set LOGBREW_SERVER_API_KEY=lbw_ingest_placeholder

Crie o cliente e faça o flush antes de retornar

Crie o cliente uma vez, fora do handler da requisição. Capture os eventos no handler. Chame flush() antes de retornar a resposta, porque a função pode parar depois de retornar.

import { createIssueAttributesFromError, SdkError } from "npm:@logbrew/sdk@^0.1.35";
import { createLogBrewNodeClient } from "npm:@logbrew/node@^0.1.20";

const logbrew = createLogBrewNodeClient({
  serverApiKey: Deno.env.get("LOGBREW_SERVER_API_KEY"),
  captureRuntimeContext: false,
  context: {
    schemaVersion: 1,
    resource: {
      service: { name: "checkout-function", version: "checkout@1" },
      runtime: { name: "deno", version: Deno.version.deno },
    },
  },
});

Deno.serve(async (request) => {
  const occurredAt = new Date().toISOString();
  logbrew.log(crypto.randomUUID(), occurredAt, {
    message: "checkout request",
    level: "info",
    metadata: { method: request.method },
  });
  let response = new Response("ok");
  try {
    await checkout(request);
  } catch (error) {
    logbrew.issue(
      crypto.randomUUID(),
      occurredAt,
      createIssueAttributesFromError(error, { service: "checkout-function" }),
    );
    response = new Response("checkout failed", { status: 500 });
  }
  try {
    await logbrew.flush();
  } catch (error) {
    console.error(error instanceof SdkError ? error.code : "logbrew_delivery_failed");
  }
  return response;
});

async function checkout(_request: Request) {
  // Your function code.
}

captureRuntimeContext: false e o contexto runtime fazem o LogBrew mostrar o Deno como runtime. Sem eles, o SDK informa a versão do Node.js que o Deno emula.Se a entrega falhar, flush() lança um SdkError, por exemplo com o código network_failure. O exemplo grava só o código de erro no log da função, e a função ainda retorna a resposta.

Implante e chame a função

Implante a função com supabase functions deploy checkout. Chame a função uma vez.Ponto de controle: o log checkout request aparece no seu projeto LogBrew.

Não coloque credenciais, corpos de requisição nem dados de clientes nos metadados dos eventos.

Primeiros passos

Conceitos

Instalar e enviar

Investigar

CLI e agentes

Suporte

Log drain do Supabase e logs de Edge Functions com o LogBrew

Envie logs da plataforma com um log drain

Capture logs e erros em Edge Functions

​Envie logs da plataforma com um log drain

​Capture logs e erros em Edge Functions

Envie logs da plataforma com um log drain

Capture logs e erros em Edge Functions