PHP e Laravel

Instalar composer require blipit/blipit

Instale o pacote blipit/blipit (0.3.0 ou mais recente) e chame init uma vez com a chave pública do projeto. Ele roda sobre o núcleo próprio do Blipit e não instala nenhum outro pacote. Exceções não capturadas, avisos e erros fatais são reportados por conta própria, e Laravel e Symfony já vêm integrados.

Cole-o no Claude Code, no Cursor ou em qualquer assistente de programação com IA. Inclui os passos e o código. Em app.blipit.io, em Chaves de API, o mesmo prompt já vem com a sua chave preenchida.
Vídeo: instalar o Blipit em qualquer stack, a partir de 1:07

1Instalar

sh
composer require blipit/blipit

2Inicialize na inicialização

PHP puro: no topo do seu front controller, antes de qualquer requisição ser tratada. O Laravel inicia o Blipit a partir da configuração, como no próximo passo. A chave fica na página Chaves do projeto. Com uma chave vazia, init grava um aviso no log de erros e retorna false em vez de lançar uma exceção.

php
use Blipit\Blipit;

Blipit::init([
    "key" => "<public key>",
    "environment" => "production",
    "release" => "myapp@1.4.2",
]);

3Obtenha suas chaves

Entre no app.blipit.io e abra Chaves de API na barra lateral, depois o seu projeto. Cada projeto tem duas chaves. A chave pública começa com blipit_pk_: ela vai no código do navegador e do app, só pode enviar eventos e é segura para qualquer pessoa ver. A chave secreta começa com blipit_sk_: ela fica no seu servidor ou no Odoo, nunca em um navegador, porque também pode ler e alterar problemas. A chave secreta é exibida uma única vez, logo depois de criada, então copie-a nesse momento; se você a perder, clique em Criar uma nova chave secreta, e a antiga para de funcionar na hora. Alguns SDKs também precisam do id do projeto, exibido na mesma página.

Chaves de API no app.blipit.io: a chave pública (blipit_pk_) para código de navegador e a chave secreta (blipit_sk_) para servidores e o Odoo.
Chaves de API no app.blipit.io: a chave pública (blipit_pk_) para código de navegador e a chave secreta (blipit_sk_) para servidores e o Odoo.
Uma nova chave secreta é exibida uma única vez. Copie-a agora: ela é armazenada com hash e não pode ser exibida novamente.
Uma nova chave secreta é exibida uma única vez. Copie-a agora: ela é armazenada com hash e não pode ser exibida novamente.

4Mantenha a chave no ambiente

Este SDK envia com a chave pública. Laravel: adicione-a ao .env e ao config/services.php; o service provider do Blipit é descoberto sozinho e inicia o Blipit a partir dessa configuração, então não é preciso mais nada. Leia os valores por meio de config, porque env() não retorna nada no código do app depois que a configuração é colocada em cache. PHP puro: leia a chave com getenv() do ambiente do servidor.

.env
BLIPIT_KEY=blipit_pk_your_public_key
config/services.php
'blipit' => [
    'key' => env('BLIPIT_KEY'),
    'environment' => env('APP_ENV'),
    'release' => env('GIT_SHA'),
],

5Mantenha as chaves fora do git

Mantenha as chaves em variáveis de ambiente ou nas configurações de segredos do seu host, nunca em código que você faz commit, e adicione seus arquivos .env ao .gitignore. Uma chave pública em uma página web é normal. Se uma chave secreta for parar no git, em uma página pública, em uma captura de tela ou em um chat, abra Chaves de API, clique em Criar uma nova chave secreta e cole a nova chave onde a antiga era usada: a chave antiga para de funcionar na hora.

.gitignore
.env
.env.local
.env.*.local

6Laravel e Symfony

Laravel: toda exceção que o handler reporta chega ao Blipit, então 404s e erros de validação ficam de fora. Consultas, linhas de log e chamadas do cliente HTTP viram breadcrumbs, e jobs em fila são rastreados. Uma linha Blipit::captureException que você já tenha em bootstrap/app.php pode ficar: a mesma exceção nunca é enviada duas vezes. Symfony: registre o listener em config/services.yaml e chame Blipit::init logo no início de public/index.php e bin/console.

config/services.yaml
Blipit\Symfony\BlipitListener:
    arguments: ['@router']
    tags:
        - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
        - { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
        - { name: kernel.event_listener, event: console.error, method: onConsoleError }

7Captura manual e tentativas de login

As tentativas de login precisam da chave secreta: no servidor, inicialize com a chave secreta em vez da pública, ou a ingestão as recusa com 403 security_needs_secret_key. Plano Scale.

php
Blipit::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());

8Confira se funciona

Abra Problemas em app.blipit.io. O primeiro evento aparece em alguns segundos, agrupado em um problema, e os responsáveis recebem um e-mail.

php
Blipit::captureMessage("Hello from PHP");

Bom saber

  • Passe "traces_sample_rate" => 0.2 em init e as requisições aparecem na página Pulse. Blipit::trace("import orders", fn () => $importer->run()) mede o tempo de qualquer bloco dentro de uma requisição ou job rastreado.
  • Atualizando da 0.2: project não é mais necessário (ainda é aceito), Blipit::dsn() e Blipit::notice() foram removidos, e before_send agora recebe e retorna o evento como um array no formato do Blipit.
  • Manter o Blipit atualizado: o guia Manter o Blipit atualizado (docs.blipit.io/updates) explica o banner de atualização, os e-mails de versões importantes, o aviso no seu console de desenvolvimento e o comando de atualização para esta plataforma.
  • Um projeto por app e plataforma: cada projeto escolhe a sua plataforma quando é criado (Android, iOS, React Native, Flutter, Web, Backend ou Odoo), e o Blipit recusa com um erro claro os dados de qualquer outra plataforma, por isso uma app iOS e uma app Android precisam de dois projetos com duas chaves. Releases, versões, taxas de falhas e builds das lojas são diferentes em cada plataforma, e misturá-los num projeto torna todos errados. Um projeto Web também aceita o lado servidor da mesma app web (o servidor Next.js ou Node), e um projeto React Native ou Flutter também aceita os seus próprios relatórios de falhas nativos de Android e iOS.

Travou? Envie um e-mail para support@blipit.io. As chaves e o id de cada projeto ficam em Chaves de API no app.blipit.io.