Instalar por plataforma
Java e Kotlin
Instalar com.github.blipit-io:blipit-java
A biblioteca blipit-java é servida pelo JitPack direto do GitHub. Ela roda sobre o núcleo próprio do Blipit, não tem dependências e funciona no Java 8 ou mais recente. Adicione o repositório e a dependência e depois chame Blipit.init uma vez na inicialização com a chave pública e o id do projeto.
1Adicione o repositório e a dependência
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.blipit-io:blipit-java:v0.2.2")
}<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.blipit-io</groupId>
<artifactId>blipit-java</artifactId>
<version>v0.2.2</version>
</dependency>2Inicialize na inicialização
Spring Boot: no topo de main, antes de SpringApplication.run, ou em um método @PostConstruct de uma classe @Configuration. Exceções não capturadas em qualquer thread são gravadas em uma fila no disco antes de o app parar e depois enviadas, então uma falha é reportada mesmo sem rede; o que sobrar é enviado na próxima inicialização.
import io.blipit.Blipit;
import io.blipit.BlipitOptions;
Blipit.init(BlipitOptions.builder()
.key("<public key>")
.project(<project id>)
.environment("production")
.release("myapp@1.4.2")
.build());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.
4Mantenha a chave no ambiente
Este SDK envia com a chave pública e o id do projeto. Leia-os de variáveis de ambiente ou, no Spring Boot, de application.properties preenchido a partir do ambiente.
blipit.key=${BLIPIT_KEY}
blipit.project=${BLIPIT_PROJECT}Blipit.init(BlipitOptions.builder()
.key(System.getenv("BLIPIT_KEY"))
.project(Long.parseLong(System.getenv("BLIPIT_PROJECT")))
.build());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.
.env
.env.local
.env.*.local6Captura 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.
Blipit.captureException(err);
Blipit.captureMessage("cache miss rate above 50%");
Blipit.captureMessage("disk almost full", Level.WARNING);
Blipit.setUser("42", "ana@example.com");
Blipit.addBreadcrumb("GET /api/cart 500", "http", Level.ERROR);
Blipit.captureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);7Confira 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.
Blipit.captureMessage("Hello from Java");Bom saber
- Kotlin usa as mesmas chamadas.
- O SDK Java não mede o tempo das requisições sozinho: para a página Pulse, envie spans de qualquer exportador OpenTelemetry para https://in.blipit.io/v1/traces com o cabeçalho X-Blipit-Key (protocolo JSON).
- Atualizando da v0.1: o enum de nível é io.blipit.Level, setUser(User) passa a ser setUser(id, email) ou setUser(id, email, username), addBreadcrumb(Breadcrumb) passa a ser addBreadcrumb(message, category, level), Blipit.dsn foi removido, captureException e captureMessage retornam o id do evento, e flush retorna se tudo foi entregue.
- 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.

