このドキュメントには、カスタムイベントおよび関連する属性を挿入し、使用するための一般的な要件とルールが含まれます。使用するメソッドに基づき、追加要件が適用される場合があります。
カスタムイベントは、以下の方法でNew Relicにレポートできます。
- APMエージェントのAPI
- イベントAPI(イベントAPIを使用する際は、追加要件があります)
- ブラウザ監視エージェントのAPI(カスタム
PageAction
イベントには、追加要件があります) - モバイル監視SDK
基本要件
カスタムイベントおよび属性をレポートする際は、サポートされているデータ型、命名構文、サイズは、これらの基本要件に従います。
要件 | 説明 |
---|---|
ペイロード | 合計最大サイズまたは長さ: 投稿ごとに最大1MB (10^6バイト)。圧縮の使用を強く推奨します。 ペイロードは UTF-8 としてエンコードする必要があります。 イベントAPIには追加HTTPレート制限があります。 |
属性のデータ型 | 属性値は、文字列、数値整数または浮動小数のいずれかです。 属性値に日付情報が含まれる場合は、インサイトデータフォーマッターを使用して、フォーマットされていないUnixタイムスタンプ(秒またはミリ秒)として定義します。 |
属性サイズ | 最大 最大属性
|
命名構文 | 属性名は、英数字文字、コロン( イベントタイプ( NRQL用の予約語は使用しないでください。 |
Null値 | データベースは、null値のデータは保存しません。 |
予約語
イベントおよび属性の名前には、以下の予約後を使用しないでください。そうしないと、予期しない結果となる場合があります。
重要
これは完全リストではありません。一般的に、将来のNew Relicの機能との衝突が発生しないように、MySQLの予約語の使用は避けてください。
キーワード | 説明 |
---|---|
| これは予約した属性名です。これが含まれている場合は、取り込み中に破棄されます。 |
| 値は整数である必要があります。整数ではない場合、属性名と値は取り込み中に破棄されます。 |
| New Relicに保存されているイベントタイプ。通常、New Relicエージェントおよびスクリプトは、これを |
禁止された |
|
| Unixエポックのタイムスタンプである必要があります。タイムスタンプは、秒またはミリ秒で定義できます。サーバーの現在時刻から前後1日(24時間)である必要があります。 |
ログ転送条件 | 以下のキーは、インフラストラクチャエージェントのログ転送機能により予約されます。 |
NRQL構文条件 | ドット付き属性など、属性名として、NRQL構文条件を使用する必要がある場合は、バッククォートで囲む必要があります。例:
|
イベントタイプの限度
現在の、eventType
値の合計数の限度は、指定した24時間の子アカウントあたり250です。この限度を超えると、New Relicはデータをフィルタリングまたは破棄する場合があります。イベントタイプには、以下が含まれます。
- New Relicエージェントからのデフォルトイベント
- New Relicエージェントからのカスタムイベント
- インサイトカスタムイベントインサーターからのカスタムイベント
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubでは、コミュニティからのサポートを受けたり、ディスカッションに参加したりすることができます。
- 当社サイトで答えを見つけて、サポートポータルの使用方法を確認してください。
- Linux、Windows、およびmacOS向けトラブルシューティングツールであるNew Relic Diagnosticsを実行してください。
- New Relicの とandドキュメント をご確認ください。