エージェントAPIの使用

エージェントAPIの使用

New Relic Roku エージェントは、Roku アプリケーションで監視システムとビデオイベント用の包括的なAPIを提供します。 APIは論理的なカテゴリに分類されているため、必要なメソッドを素早く見つけることができます。

APIカテゴリ

APIメソッドをカテゴリ別に閲覧する：

カテゴリー	説明
エージェントの初期化	エージェントを初期化し、ビデオセッションの追跡を制御する
ライフサイクルメソッド	アプリケーションとシーンのライフサイクルイベントを追跡します。
イベント追跡	カスタムイベント、システムイベント、ビデオイベントを送信する
HTTP監視	ネットワークのrequestsとレスポンスを監視する
カスタムアトリビュート	フィルタリングと分析のためにイベントにメタデータを追加する
ロギング	ログメッセージをNew Relicに送信する
指標	カスタム定量測定を追跡する
収穫設定	New Relicへのデータ送信タイミングを制御する
構成	実行時にエージェント設定を更新する
ドメイン管理	URLのドメイン置換を設定する
ユーザー識別	イベントを特定のユーザーに関連付ける

クイックスタートガイド

1. エージェントを初期化する

まず、Roku アプリケーションでNew Relicエージェントを初期化します。

sub Main(aa as Object)
    screen = CreateObject("roSGScreen")
    m.port = CreateObject("roMessagePort")
    screen.setMessagePort(m.port)
    scene = screen.CreateScene("VideoScene")
    screen.show()

    m.nr = NewRelic("ACCOUNT ID", "API KEY")

2. システムログを開始する

システムイベント監視を有効にする：

m.syslog = NewRelicSystemStart(m.port)

3. ビデオセッションを追跡する

モニタービデオ再生:

NewRelicVideoStop(m.nr)

4. カスタムイベントを送信する

アプリケーションイベントを追跡する：

nrSendCustomEvent(m.nr, "MyEvent", "MY_ACTION")
attr = {"key0":"val0", "key1":"val1"}
nrSendCustomEvent(m.nr, "MyEvent", "MY_ACTION", attr)

5.カスタムアトリビュートの追加

イベントにメタデータを追加する：

nrSetCustomAttribute(m.nr, "myNum", 123, "CONTENT_START")
nrSetCustomAttribute(m.nr, "myString", "hello")

6. ユーザー識別子を設定する

イベントを特定のユーザーに関連付ける：

nrSetUserId(m.nr, "TEST_USER")