• /
  • ログイン

APM: Report custom events and attributes

If you have APM, you can report custom event data. You can then query and visualize your data in New Relic.

Data considerations

New Relic agents send event data to New Relic as part of the normal harvest cycle every five seconds for agent versions supporting real time streaming.

Sending a lot of events can increase the memory overhead of the agent. New Relic enforces an upper limit of 833 custom events every 5 seconds. Additionally, posts greater than 1MB (10^6 bytes) in size will not be recorded, regardless of the custom event limit.

You can also send custom events using the Event API (without need for APM). However, be aware that custom events sent with the agent APIs are not compatible with high security mode.

ヒント

For more information, check out New Relic University’s tutorial Adding custom data with the APM agent API. Or, go directly to the full online course Custom data with APM.

Record custom events and attributes

You can add your own custom APM events and attributes, which you can then use for querying and charting. This is one of several ways to report custom data.

To record a custom event, follow the procedures for your New Relic language agent. To add custom attributes to APM events, you must first enable them for your New Relic APM agent, and then make an API call to record the attribute. Follow the agent-specific custom attribute procedures.

When creating your own custom events and attributes, follow data requirements for:

Timestamps

You may not specify a timestamp on events that are collected and recorded via the agent. The agent will automatically assign a timestamp to events based on when they are recorded via the API.

上限値および文字の制限

See Custom event data requirements for size limits, data types, and naming syntax requirements.

予約語

Before creating custom attributes, review New Relic's list of reserved terms used by NRQL. Otherwise unexpected results may occur.

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.