このドキュメントには、カスタムイベントおよび関連する属性を挿入し、使用するための一般的な要件とルールが含まれます。使用するメソッドに基づき、追加要件が適用される場合があります。
カスタムイベントは、以下の方法でNew Relicにレポートできます。
- エージェントAPI
- イベントAPI(イベントAPIを使用する際は、追加要件があります)
- エージェントAPIと(カスタム
PageAction
イベントには追加の要件があります) - モバイル監視SDK
基本要件
カスタムイベントおよび属性をレポートする際は、サポートされているデータ型、命名構文、サイズは、これらの基本要件に従います。
要件 | 説明 |
---|---|
ペイロード | 合計最大サイズまたは長さ:POSTあたり最大1MB(10^6バイト)1MB (10^6 bytes) maximum per POST。圧縮の使用を強く推奨します。 ペイロードはUTF-8としてエンコードする必要があります。 イベントAPIには追加HTTPレート制限があります。 |
属性のデータ型 | 属性値は、文字列、数値整数または浮動小数のいずれかです。日付と時刻データの書式設定についての詳細は、カスタム日付/時刻を参照してください。 |
属性制限 | 属性名の最大長:255文字。 カスタムアトリビュート値の最大長:
|
イベントと属性の命名構文 | イベント名には、英数字、コロン( 名前は文字で始めることをお勧めします。それ以外の記号で始める場合は、クエリ時に名前をバッククォートで囲む必要があります。クエリでバッククォートが必要な場合の詳細については、NRQLリファレンスを参照してください。 NRQL用の予約語は使用しないでください。 イベント名の最大長:255文字。 |
Null値 | データベースは、null値のデータは保存しません。 |
予約語
イベントおよび属性の名前には、以下の予約後を使用しないでください。そうしないと、予期しない結果となる場合があります。
重要
これは完全リストではありません。一般的に、将来のNew Relicの機能との衝突が発生しないように、MySQLの予約語の使用は避けてください。
Keyword | Description |
---|---|
| これは予約した属性名です。これが含まれている場合は、取り込み中に破棄されます。 |
| 値は整数である必要があります。整数ではない場合、属性名と値は取り込み中に破棄されます。 |
| New Relicに保存されているイベントタイプ。通常、New Relicエージェントおよびスクリプトは、これを |
禁止された |
|
| Unixエポックのタイムスタンプである必要があります。タイムスタンプは、秒またはミリ秒で定義できます。サーバーの現在時刻から前後1日(24時間)である必要があります。 |
ログ転送条件 | 次のキーは、Infrastructureエージェントのログ転送機能( |
NRQL構文条件 | NRQL構文規則を、ドット付き属性を含む属性名に使用する必要がある場合は、バッククォートで囲む必要があります。例:
|
イベントタイプの限度
現在の、eventType
値の合計数の限度は、指定の24時間以内のアカウント(組織あたりではなく)あたり250です。アカウントがこの限度を超えると、New Relicはデータをフィルタリングまたは破棄する場合があります。イベントタイプには、以下が含まれます。
- New Relicエージェントとインテグレーションからのデフォルトイベント
- エージェントからのカスタムイベントまたは
- イベントAPIからのカスタムイベント