イベントが届かない
イベントが表示されないよくある原因と、どれに当てはまるかの見分け方。
まず curl でイベントを 1 つ送ってみてください(クイックスタート を参照)。問題の多くはレスポンスを見ればわかります。
| 見えるもの | 原因 | 対処 |
|---|---|---|
200 で "accepted":0 と rejected のリスト | 各行に拒否された理由が示されています | 示されたフィールドを直してください(よくある行のエラー を参照)。拒否された行は絶対に再送しないでください。 |
401 unknown or revoked key | キーが間違っている、無効化されている、または Lyrelog のキーではありません | キーをコピーし直すか、API keys で新しいキーを作成してください |
403 this key cannot write events | Read events のキーです | Send events のキー(lyr_ing_)を使ってください |
415 | Content-Type が application/x-ndjson ではありません | ヘッダーを設定してください |
429 で plan、limit、used が返る | Free プランの今月のクォータを使い切りました | SDK はイベントを保持し、月が替わったら送信します。プランと使用量 を参照してください |
429 で source_limit が返る | 1 つのアドレスが、公開キーで 1 日の割り当て分を送り切りました | サーバーからはサーバーキー(lyr_srv_)を使ってください。それ以外の場合、イベントは翌日(UTC)に再開します。1 つのアドレスの 1 日の割り当て を参照してください |
429 rate limit for this project | 1 分あたり 60,000 イベントを超えました | Retry-After の時間だけ待ってください |
425 で verification_required が返る | プロジェクトがそのプラットフォームからは検証済みイベントしか受け付けない設定で、このバッチは検証されていません | SDK はバッチを保持して再試行します。自分を証明できないビルド、シミュレーター、エミュレーター、デバイスのイベントは通過できません。それらが必要な間は Project settings でこのオプションをオフにしてください。検証済みイベント を参照してください |
503 | サーバーが混み合っているか、一時的にストレージに接続できません | Retry-After のあとで同じバイト列を再送してください(SDK は自動で行います) |
3xx | エンドポイントが間違っています | https://ingest.lyrelog.com を使ってください |
| 受け付けられたが、ダッシュボードに表示されない | ダッシュボードは 1 つの環境だけを表示します。Xcode から実行したビルド、シミュレーター、Android のデバッグビルド、localhost、NODE_ENV=production なしの Node は development を送ります | 上部バーで development か All environments を選び、All platforms も選んでください |
| 受け付けられたが、時刻がずれている | ts が保持期間より古いか 1 日以上先だったため、届いた時刻で保存されました | 属性 _lyrelog_ts_clamped を確認し、現在時刻を送るようにしてください |
| Swift アプリから何も届かない | 同意(consent)が .pending または .denied の間、SDK は何も送りません | 同意 を参照してください |
| Android アプリから何も届かない | 同意が PENDING または DENIED の間は SDK は何も送りません。または、エンドポイントが SDK の受け付けるものではありません | 同意 と 開発中とテスト を参照してください |
| React Native または Flutter アプリから何も届かない | 同意が pending または denied になっている、エンドポイントがネイティブ SDK の受け付けるものではない、またはパッケージを追加したあとアプリをリビルドしていません | React Native と Flutter の「同意」、Flutter の 開発中とテスト を参照してください |
| JVM サーバーから何も届かない | キーが空です(start は false を返し、何もしません)。または、シャットダウンフックが送信する前にプロセスが終了しました | 開始 と フラッシュと停止 を参照してください |
| サーバーからのイベントの国が違う | 国は送信元のアドレスから決まります | 国 を参照してください |
SDK のメッセージ
各 SDK は、アプリをクラッシュさせることなく、自身の問題(間違ったエンドポイント、拒否されたキー、破棄されたバッチ)を報告します。
| SDK | 確認する場所 |
|---|---|
| Swift | 統合ログ(unified log)のサブシステム com.lyrelog.sdk。Console.app または Xcode のコンソール |
| Android | Logcat のタグ Lyrelog、debug レベル |
| React Native | ネイティブ SDK のログ。iOS では統合ログ(Xcode のコンソール)、Android では上記と同じく logcat。キーやネイティブモジュールがない場合は、開発ビルドで Metro に console.warn が 1 回出ます |
| Flutter | ネイティブ SDK のログ。iOS では統合ログ(Xcode のコンソール)、Android では上記と同じく logcat。mirrorToConsole: true にすると、すべてのイベントもそこに出力されます |
| JavaScript | [lyrelog] で始まる console.warn の行 |
| Python | lyrelog ロガー(標準の logging) |
| Go | Config.ErrorLog。設定がなければ、最初の問題が stderr に 1 回だけ出ます |
| JVM | 標準エラー出力の lyrelog: で始まる行(プロセスごとに 1 回)、または Configuration.diagnostics |
それでも解決しない場合
プロジェクト ID(Project settings の Details にあります)と、イベントを送った時刻を添えて hello@lyrelog.com にご連絡ください。キーは絶対に送らないでください。