Installation par plateforme
.NET
Installation dotnet add package Blipit
Ajoutez le paquet Blipit (0.2.0 ou plus récent) et appelez Init une fois au démarrage avec la clé publique et l'identifiant de votre projet. Il fonctionne sur le cœur de Blipit. Les exceptions non gérées et les tâches en échec que personne n'a attendues sont signalées d'elles-mêmes, et ASP.NET Core ne demande aucun paquet supplémentaire.
1Installation
dotnet add package Blipit2Initialiser au démarrage
Conservez le handle renvoyé pendant toute la durée de vie du processus. Les deux valeurs sont sur la page Clés du projet.
using Blipit;
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = "<public key>",
Project = "<project id>",
Environment = "production",
Release = "myapp@1.4.2",
});3Obtenir vos clés
Connectez-vous sur app.blipit.io et ouvrez Clés API dans la barre latérale, puis votre projet. Chaque projet a deux clés. La clé publique commence par blipit_pk_ : elle va dans le code navigateur et applicatif, ne peut qu'envoyer des événements et peut être vue par n'importe qui sans risque. La clé secrète commence par blipit_sk_ : elle reste sur votre serveur ou dans Odoo, jamais dans un navigateur, car elle peut aussi lire et modifier les problèmes. La clé secrète n'est affichée qu'une fois, juste après sa création, alors copiez-la à ce moment-là ; si vous la perdez, appuyez sur Créer une nouvelle clé secrète, et l'ancienne cesse aussitôt de fonctionner. Certains SDK ont aussi besoin de l'identifiant de projet, affiché sur la même page.
4Gardez la clé dans la configuration
Ce SDK envoie avec la clé publique et l'identifiant de projet. Gardez-les dans les user secrets pendant le développement et dans des variables d'environnement en production (Blipit__Key et Blipit__Project), puis lisez-les depuis la configuration.
dotnet user-secrets set "Blipit:Key" "blipit_pk_your_public_key"
dotnet user-secrets set "Blipit:Project" "12"using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = builder.Configuration["Blipit:Key"],
Project = builder.Configuration["Blipit:Project"],
});5Gardez les clés hors de git
Gardez les clés dans des variables d'environnement ou dans les réglages de secrets de votre hébergeur, jamais dans du code que vous committez, et ajoutez vos fichiers .env à .gitignore. Une clé publique dans une page web est normale. Si une clé secrète se retrouve un jour dans git, sur une page publique, dans une capture d'écran ou dans un chat, ouvrez Clés API, appuyez sur Créer une nouvelle clé secrète, et collez la nouvelle clé partout où l'ancienne était utilisée : l'ancienne clé cesse immédiatement de fonctionner.
.env
.env.local
.env.*.local6ASP.NET Core et journalisation
Rien d'autre à ajouter : appelez Init en haut de Program.cs. Les exceptions des endpoints, contrôleurs et middlewares sont signalées avec la requête, y compris quand UseExceptionHandler les traite, et avec TracesSampleRate défini, chaque requête échantillonnée est chronométrée dans Pulse selon sa route. BlipitLoggerProvider transforme Information et au-dessus en breadcrumbs, et Error et au-dessus en événements.
var builder = WebApplication.CreateBuilder(args);
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = builder.Configuration["Blipit:Key"],
Project = builder.Configuration["Blipit:Project"],
TracesSampleRate = 0.2,
});
builder.Logging.AddProvider(new BlipitLoggerProvider());7Capture manuelle et tentatives de connexion
Les tentatives de connexion exigent la clé secrète : sur le serveur, initialisez avec la clé secrète au lieu de la clé publique, sinon l'ingestion les refuse avec 403 security_needs_secret_key. Offre Scale.
Blipit.Blipit.CaptureException(ex);
Blipit.Blipit.CaptureMessage("cache miss rate above 50%", BlipitLevel.Warning);
Blipit.Blipit.SetUser(id: "42", email: "ana@example.com");
Blipit.Blipit.CaptureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);8Vérifier que ça fonctionne
Ouvrez Problèmes dans app.blipit.io. Le premier événement apparaît en quelques secondes, regroupé en un problème, et les responsables reçoivent un e-mail.
Blipit.Blipit.CaptureMessage("Hello from .NET");Bon à savoir
- Cible netstandard2.0 et net8.0.
- TracesSampleRate = 0.2 dans les options envoie les requêtes vers la page Pulse ; await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) ajoute une étape chronométrée dans une requête.
- Mise à jour depuis 0.1 : retirez le paquet ASP.NET Core supplémentaire et la ligne builder.WebHost dont 0.1 avait besoin, car Init couvre ASP.NET Core. Blipit.Dsn, Blipit.Apply, BlipitOptions.Configure et PackageName sont supprimés, CaptureMessage et AddBreadcrumb prennent BlipitLevel, et les appels de capture renvoient l'identifiant de l'événement sous forme de chaîne.
- Garder Blipit à jour : le guide Garder Blipit à jour (docs.blipit.io/updates) explique la bannière de mise à jour, les e-mails pour les versions importantes, l'avis dans votre console de développement et la commande de mise à jour pour cette plateforme.
- Un projet par application et par plateforme : chaque projet choisit sa plateforme à sa création (Android, iOS, React Native, Flutter, Web, Backend ou Odoo), et Blipit refuse avec une erreur claire les données de toute autre plateforme. Une app iOS et une app Android ont donc besoin de deux projets avec deux clés. Les releases, les versions, les taux de plantage et les builds des stores diffèrent selon la plateforme, et les mélanger dans un projet les rend tous faux. Un projet Web accepte aussi la partie serveur de la même app web (le serveur Next.js ou Node), et un projet React Native ou Flutter accepte aussi ses propres rapports de plantage natifs Android et iOS.
Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.

