Roku 로그 수집

Datadog의 dd-sdk-roku 로깅 라이브러리를 사용해 Roku 채널에서 Datadog으로 로그를 전송하고 다음 기능을 활용해 보세요.

JSON 네이티브 형식으로 Datadog에 로그인하세요.
context 및 그외 커스텀 속성을 전송된 각 로그에 추가합니다.
실제 클라이언트 IP 주소와 User-Agents를 기록합니다.
자동 대량 포스트로 네트워크 사용량을 최적화했습니다.

설정

ROPM를 사용하여 프로젝트에 종속성을 추가하거나 최신 zip 아카이브를 다운로드하여 프로젝트에서 파일 압축을 풉니다.
```
ropm install datadog-roku
```

Datadog 클라이언트 토큰과 Datadog UI에서 새 RUM 애플리케이션 생성 시 만들어진 애플리케이션 ID로 라이브러리를 초기화합니다(자세한 내용을 확인하려면 Roku RUM 수집 시작하기 참조). 보안상의 이유로 반드시 클라이언트 토큰을 사용해야 합니다. Datadog API 키를 사용하여 dd-sdk-roku 라이브러리를 설정할 수 없습니다. Roku 채널의 패키지의 클라이언트-사이드가 노출될 수 있기 때문입니다.

클라이언트 토큰을 설정하는 방법에 관한 자세한 내용을 확인하려면 클라이언트 토큰 설명서를 참고하세요.

sub RunUserInterface(args as dynamic)
    screen = CreateObject("roSGScreen")
    scene = screen.CreateScene("MyScene")
    screen.show()

    datadogroku_initialize({
        clientToken: "<CLIENT_TOKEN>",
        applicationId: "<APPLICATION_ID>"
        site: "us1",
        env: "<ENV_NAME>",
        sessionSampleRate: 100, ' the percentage (integer) of sessions to track
        launchArgs: args
    })

    ' complete your channel setup here
end sub

sub RunUserInterface(args as dynamic)
    screen = CreateObject("roSGScreen")
    scene = screen.CreateScene("MyScene")
    screen.show()

    datadogroku_initialize({
        clientToken: "<CLIENT_TOKEN>",
        applicationId: "<APPLICATION_ID>"
        site: "eu1",
        env: "<ENV_NAME>",
        sessionSampleRate: 100, ' the percentage (integer) of sessions to track
        launchArgs: args
    })

    ' complete your channel setup here
end sub

sub RunUserInterface(args as dynamic)
    screen = CreateObject("roSGScreen")
    scene = screen.CreateScene("MyScene")
    screen.show()

    datadogroku_initialize({
        clientToken: "<CLIENT_TOKEN>",
        applicationId: "<APPLICATION_ID>"
        site: "us3",
        env: "<ENV_NAME>",
        sessionSampleRate: 100, ' the percentage (integer) of sessions to track
        launchArgs: args
    })

    ' complete your channel setup here
end sub

sub RunUserInterface(args as dynamic)
    screen = CreateObject("roSGScreen")
    scene = screen.CreateScene("MyScene")
    screen.show()

    datadogroku_initialize({
        clientToken: "<CLIENT_TOKEN>",
        applicationId: "<APPLICATION_ID>"
        site: "us5",
        env: "<ENV_NAME>",
        sessionSampleRate: 100, ' the percentage (integer) of sessions to track
        launchArgs: args
    })

    ' complete your channel setup here
end sub

sub RunUserInterface(args as dynamic)
    screen = CreateObject("roSGScreen")
    scene = screen.CreateScene("MyScene")
    screen.show()

    datadogroku_initialize({
        clientToken: "<CLIENT_TOKEN>",
        applicationId: "<APPLICATION_ID>"
        site: "ap1",
        env: "<ENV_NAME>",
        sessionSampleRate: 100, ' the percentage (integer) of sessions to track
       launchArgs: args
    })

    ' complete your channel setup here
end sub

(옵션) 애플리케이션을 작성할 때 글로벌 로드의 datadogVerbosity 속성을 설정하여 개발 로그를 활성화할 수 있습니다. 우선 순위가 해당 수준 이상이거나 동일한 라이브러리의 내부 메시지 전체가 다음과 같이 Roku 장치 텔넷 아웃풋에 로깅됩니다.
```
' 0 = none; 1 = error; 2 = warning; 3 = info; 4 = verbose;
m.globalNode.addFields({ datadogVerbosity: 2 }) 
```

다음 함수 중 하나를 사용해 커스텀 로그 항목을 Datadog로 바로 보냅니다.

msg = "A log message"
m.global.datadogLogsAgent.callfunc("logOk", msg, {})
m.global.datadogLogsAgent.callfunc("logDebug", msg, {})
m.global.datadogLogsAgent.callfunc("logInfo", msg, {})
m.global.datadogLogsAgent.callfunc("logNotice", msg, {})
m.global.datadogLogsAgent.callfunc("logWarn", msg, {})
m.global.datadogLogsAgent.callfunc("logError", msg, {})
m.global.datadogLogsAgent.callfunc("logCritical", msg, {})
m.global.datadogLogsAgent.callfunc("logAlert", msg, {})
m.global.datadogLogsAgent.callfunc("logEmergency", msg, {})

(옵션) 전송하는 로그에 속성을 추가하기 위해 로그 메시지에 관련 어레이(Associative Array)를 제공하세요. AssocArray의 각 항목이 속성으로 추가됩니다.
```
 m.global.datadogLogsAgent.callfunc(
     "logInfo", 
     "Video started", 
     { video_id: 42, video_type: "advert"}
 )
```