プラットフォーム別インストール
.NET
インストール dotnet add package Blipit
Blipit パッケージ(0.2.0 以降)を追加し、起動時にプロジェクトの公開キーとプロジェクト ID で Init を一度呼び出します。Blipit 独自のコアで動作します。未処理の例外と、誰も await しなかった失敗タスクは自動で報告され、ASP.NET Core に追加のパッケージは必要ありません。
1インストール
dotnet add package Blipit2起動時に初期化
返されたハンドルはプロセスの存続中保持してください。両方の値はプロジェクトのキーページにあります。
using Blipit;
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = "<public key>",
Project = "<project id>",
Environment = "production",
Release = "myapp@1.4.2",
});3キーを取得
app.blipit.io にサインインし、サイドバーの「APIキー」を開いてプロジェクトを選びます。各プロジェクトには2つのキーがあります。公開キーは blipit_pk_ で始まり、ブラウザやアプリのコードに置くものです。イベントの送信しかできないため、誰に見られても安全です。シークレットキーは blipit_sk_ で始まり、サーバーまたは Odoo に置き、ブラウザには決して置きません。イシューの読み取りや変更もできるためです。シークレットキーは作成直後に一度だけ表示されるので、そのときにコピーしてください。紛失した場合は「新しいシークレットキーを作成」を押すと、古いキーは即座に無効になります。一部の SDK では、同じページに表示されるプロジェクト ID も必要です。
4キーを構成に保管する
この SDK は公開キーとプロジェクト ID で送信します。開発中はユーザーシークレットに、本番環境では環境変数(Blipit__Key と Blipit__Project)に保管し、構成から読み込みます。
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"],
});5キーを git に含めない
キーは環境変数またはホスティング先のシークレット設定に保管し、コミットするコードには決して書かないでください。また、.env ファイルを .gitignore に追加してください。Web ページに公開キーがあるのは通常のことです。シークレットキーが git、公開ページ、スクリーンショット、チャットなどに漏れた場合は、「APIキー」を開いて「新しいシークレットキーを作成」を押し、古いキーを使っていた箇所すべてに新しいキーを貼り付けてください。古いキーは即座に無効になります。
.env
.env.local
.env.*.local6ASP.NET Core とログ
追加するものはありません。Program.cs の先頭で Init を呼び出すだけです。エンドポイント、コントローラー、ミドルウェアからの例外は、UseExceptionHandler が処理した場合も含めてリクエスト付きで報告されます。TracesSampleRate を設定すると、サンプリングされた各リクエストがルートごとに Pulse で計測されます。BlipitLoggerProvider は Information 以上をブレッドクラムに、Error 以上をイベントにします。
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());7手動キャプチャとログイン試行
ログイン試行にはシークレットキーが必要です。サーバーでは公開キーではなくシークレットキーで初期化してください。そうしないと受信側が 403 security_needs_secret_key で拒否します。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);8動作確認
app.blipit.io で「イシュー」を開きます。数秒以内に最初のイベントがイシューにまとめられて表示され、担当者にメールが届きます。
Blipit.Blipit.CaptureMessage("Hello from .NET");知っておくと便利
- netstandard2.0 と net8.0 をターゲットにしています。
- オプションで TracesSampleRate = 0.2 を指定すると、リクエストが Pulse ページに送られます。await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) はリクエスト内に計測ステップを追加します。
- 0.1 からのアップグレード:Init が ASP.NET Core に対応するため、0.1 で必要だった ASP.NET Core 用の追加パッケージと builder.WebHost の行を削除してください。Blipit.Dsn、Blipit.Apply、BlipitOptions.Configure、PackageName は削除され、CaptureMessage と AddBreadcrumb は BlipitLevel を受け取り、capture 系の呼び出しはイベント ID を文字列で返します。
- Blipit を最新に保つ:「Blipit を最新に保つ」ガイド(docs.blipit.io/updates)で、更新バナー、重要なリリースのメール、開発コンソールのお知らせ、このプラットフォームの更新コマンドを説明しています。
- アプリとプラットフォームごとに 1 つのプロジェクト:各プロジェクトは作成時にプラットフォーム(Android、iOS、React Native、Flutter、Web、Backend、Odoo)を選び、Blipit はほかのプラットフォームからのデータをわかりやすいエラーで拒否します。そのため iOS アプリと Android アプリには、キーが別々の 2 つのプロジェクトが必要です。リリース、バージョン、クラッシュ率、ストア向けビルドはプラットフォームごとに異なり、1 つのプロジェクトに混ぜるとすべての数字が正しくなくなります。Web プロジェクトは同じ Web アプリのサーバー側(Next.js サーバーや Node)も受け付け、React Native と Flutter のプロジェクトは自身の Android と iOS のネイティブクラッシュレポートも受け付けます。
お困りですか?support@blipit.io までメールしてください。各プロジェクトのキーとプロジェクト ID は app.blipit.io の「APIキー」にあります。

