# アクティブトレースを取得する
trace = Datadog::Tracing.active_trace

# 必須ユーザー ID タグを設定する
Datadog::Kit::Identity.set_user(trace, id: 'd131dd02c56eeec4')

# または、オプションのユーザーモニタリングタグを設定する
Datadog::Kit::Identity.set_user(
  trace,

  # 必須 ID
  id: 'd131dd02c56eeec4',

  #セマティクスが分かっているオプションタグ
  name: 'Jean Example',
  email:, 'jean.example@example.com',
  session_id:, '987654321',
  role: 'admin',
  scope: 'read:message, write:files',

  # オプションの自由形式タグ
  another_tag: 'another_value',
)

# アクティブトレースを取得する
trace = Datadog::Tracing.active_trace

# 必須ユーザー ID タグを設定する
trace.set_tag('usr.id', 'd131dd02c56eeec4')

# セマティクスが分かっているユーザーモニタリングタグをオプションで設定する
trace.set_tag('usr.name', 'Jean Example')
trace.set_tag('usr.email', 'jean.example@example.com')
trace.set_tag('usr.session_id', '987654321')
trace.set_tag('usr.role', 'admin')
trace.set_tag('usr.scope', 'read:message, write:files')

# 自由形式のタグを設定する
trace.set_tag('usr.another_tag', 'another_value')

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doLogin(String userName, String password) {
        // ここで userName と password の認証情報を使って User を取得します
        User user = checkLogin(userName, password);

        Map<String, String> metadata = new HashMap<>();
        metadata.put("email", user.getEmail());
        metadata.put("usr.login", userName);

        // システムに複数の "テナント" がある場合は指定してください。テナントはユーザーを区分する環境やグループを指します
        metadata.put("usr.org", usr.getTenant());

        // ユーザー認証の成功イベントを記録します
        GlobalTracer
            .getEventTracker()
            .trackLoginSuccessEvent(user.getId(), metadata);

    }
}

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doLogin(String userName, String password) {
        // ここで userName と password の認証情報を使って User を取得します
        User user = checkLogin(userName, password);

        // この関数が null を返した場合、ユーザーは存在しません
        boolean userExists = (user != null);
        String userId = null;
        Map<String, String> metadata = new HashMap<>();
        metadata.put("usr.login", userName);
        if (userExists != null) {
            userId = getUserId(userName)
            metadata.put("email", user.getEmail());
        } else {
            userId = userName;
        }

        // ユーザー認証の失敗イベントを記録します
        GlobalTracer
            .getEventTracker()
            .trackLoginFailureEvent(userId, userExists, metadata);
    }
}

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doSignup(String userId, String email) {
        // ここでユーザー アカウントを作成します
        User user = createUser(userId, email);

        Map<String, String> metadata = new HashMap<>();
        metadata.put("usr.id", user.getId());

        // ユーザー登録イベントを記録します
        GlobalTracer
            .getEventTracker()
            .trackCustomEvent("users.signup", metadata);
    }
}

using Datadog.Trace.AppSec;

void OnLogonSuccess(string userId, string login...)
{
    // metadata は任意です
    var metadata = new Dictionary<string, string>()
    {
        { "usr.login", login }
    };
    EventTrackingSdk.TrackUserLoginSuccessEvent(userId, metadata);

    // ...
}

using Datadog.Trace.AppSec;

void OnLogonFailure(string userId, string login, bool userExists, ...)
{
    // userId を指定できない場合は、ユーザー名やメール アドレスなど、一意なユーザー識別子を代わりに使えます
    // metadata は任意です
    var metadata = new Dictionary<string, string>()
    {
        { "usr.login", login }
    };
    EventTrackingSdk.TrackUserLoginFailureEvent(userId, userExists, metadata);

    // ...
}

void OnUserSignupComplete(string userId, ...)
{
    // metadata パラメーターはオプションですが、"usr.id" を追加します
    var metadata = new Dictionary<string, string>()
    {
        { "usr.id", userId }
    };
    // カスタムビジネスロジックの追跡を活用し、ユーザーのサインアップを追跡します
    EventTrackingSdk.TrackCustomEvent("users.signup", metadata);

    // ...
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  metadata := make(map[string]string) //* 任意の追加のイベント メタデータ */
  userdata := /* 任意の追加ユーザー データ */

  metadata["usr.login"] = "user-email"

  // ログイン成功を追跡します。`my-uid` はユーザーを一意に識別できる値 (数値 ID、ユーザー名、メール アドレスなど) に置き換えてください
  if appsec.TrackUserLoginSuccessEvent(r.Context(), "my-uid", metadata, userdata) != nil {
    // 指定したユーザー ID はブロックされているため、ハンドラーはできるだけ早く中断します。
    // ブロッキング レスポンスは appsec ミドルウェアが送信します。
    return
  }
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  exists := /* 指定したユーザー ID が存在するかどうか */
  metadata := make(map[string]string) /* 任意の追加のイベント メタデータ */
  metadata["usr.login"] = "user-email"

  // `my-uid` はユーザーを一意に識別できる値 (数値 ID、ユーザー名、メール アドレスなど) に置き換えてください
  appsec.TrackUserLoginFailureEvent(r.Context(), "my-uid", exists, metadata)
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  metadata := map[string]string{"usr.id": "my-uid"}

  // カスタム ビジネス ロジックのトラッキングを利用して、ユーザー登録を追跡します
  appsec.TrackCustomEvent(r.Context(), "users.signup", metadata)
}

require 'datadog/kit/appsec/events'

trace = Datadog::Tracing.active_trace
# `my_user_id` は、ユーザーを一意に識別できる値 (数値 ID、ユーザー名、メール アドレスなど) に置き換えてください 
Datadog::Kit::AppSec::Events.track_login_success(trace, user: { id: 'my_user_id' }, { 'usr.login': 'my_user_email' })

require 'datadog/kit/appsec/events'
trace = Datadog::Tracing.active_trace

# `my_user_id` は、ユーザーを一意に識別できる値 (数値 ID、ユーザー名、メール アドレスなど) に置き換えてください

# ユーザーが存在する場合
Datadog::Kit::AppSec::Events.track_login_failure(trace, user_id: 'my_user_id', user_exists: true, { 'usr.login': 'my_user_email' })

# ユーザーが存在しない場合
Datadog::Kit::AppSec::Events.track_login_failure(trace, user_id: 'my_user_id', user_exists: false, { 'usr.login': 'my_user_email' })

require 'datadog/kit/appsec/events'
trace = Datadog::Tracing.active_trace

# `my_user_id` は、ユーザーを一意に識別できる値 (数値 ID、ユーザー名、メール アドレスなど) に置き換えてください

# カスタム ビジネス ロジックのトラッキングを利用して、ユーザー登録を追跡します
Datadog::Kit::AppSec::Events.track('users.signup', trace, nil, { 'usr.id': 'my_user_id'})

<?php
\datadog\appsec\track_user_login_success_event($id, ['usr.login' => $email])
?>

<?php
// 数値の userId がない場合でも、userId として一意な文字列 (ユーザー名やメール アドレスなど) を使用できます
// 値はユーザーごとに一意である必要があります (攻撃者や IP ごとではなく)
\datadog\appsec\track_user_login_failure_event($id, $exists, ['usr.login' => $email])
?>

<?php
\datadog\appsec\track_custom_event('users.signup', ['usr.id' => $id]);
?>

const tracer = require('dd-trace')

// コントローラー内:
const user = {
id: 'user-id', // id は必須です。ID がない場合でも、一意な識別子 (ユーザー名やメール アドレスなど) が使えます
  email: 'user@email.com' // ほかのフィールドは任意です
}
const user = 'user-id' // user は ID だけでもかまいません
const login = 'user@email.com'
const metadata = { 'key': 'value' } // 任意のフィールドを追加できます

// ユーザー認証の成功イベントを記録します
// user と metadata は任意です
tracer.appsec.eventTrackingV2.trackUserLoginSuccess(login, user, metadata)

const tracer = require('dd-trace')

// コントローラー内:
const login = 'user-id' // ユーザーがログインに使う文字列
const userExists = true // 例: データベースにその login が存在するかどうか
const metadata = { 'key': 'value' } // 任意のフィールドを追加できます

// ユーザー認証の失敗イベントを記録します
// userExists は任意で、指定しない場合は false になります
// metadata は任意です
tracer.appsec.eventTrackingV2.trackUserLoginFailure(login, userExists, metadata)

const tracer = require('dd-trace')

// コントローラーで
const eventName = 'users.signup'
const metadata = { 'usr.id': 'user-id' }

tracer.appsec.trackCustomEvent(eventName, metadata)

const tracer = require('dd-trace')

// コントローラー内:
const user = {
  id: 'user-id',
  email: 'user@email.com'
} // 以前と同じ形式ですが、このオブジェクト自体は任意になりました。ユーザー ID を渡しておくと、侵害後のアクティビティの関連付けに役立ちます 

const login = 'user@email.com' // 新しい必須引数

const metadata = {
// 'usr.login': 'user@email.com', metadata に含める必要はなくなりました。先頭の引数として渡します
  'key': 'value'
}

// tracer.appsec.trackUserLoginSuccessEvent(user, metadata) // 非推奨
tracer.appsec.eventTrackingV2.trackUserLoginSuccess(login, user, metadata)

const tracer = require('dd-trace')

// 非推奨メソッドを使うコントローラー内:
const userId = 'user-id' // 必須ではなくなりましたが、取得できるなら渡しておくと便利です
const login = 'user@email.com' // 新しい必須引数
const userExists = true
const metadata = {
// 'usr.login': 'user@email.com', metadata に含める必要はなくなりました。先頭の引数として渡します
  'usr.id': userId, // ログイン失敗を他のユーザー アクティビティと関連付けるのに役立ちます
  'key': 'value'
}

// tracer.appsec.trackUserLoginFailureEvent(userId, userExists, metadata) // 非推奨
tracer.appsec.eventTrackingV2.trackUserLoginFailure(login, userExists, metadata)

from ddtrace.appsec.trace_utils import track_user_login_success_event
from ddtrace import tracer
metadata = {"usr.login": "user@email.com"}
# name、email、scope、role、session_id、propagate は任意の引数です。
# propagate 以外はデフォルトが None、propagate はデフォルトが True です。
# これらは set_user() 関数に渡されます
track_user_login_success_event(tracer, "userid", metadata)

from ddtrace.appsec.trace_utils import track_user_login_failure_event
from ddtrace import tracer
metadata = {"usr.login": "user@email.com"}
# exists は、ログインに失敗したユーザーがシステム内に存在するかどうかを示します
exists = False
# 数値の userId がない場合でも、ユーザー名やメール アドレスなど、一意な識別子で代用できます
track_user_login_failure_event(tracer, "userid", exists, metadata)

from ddtrace.appsec.trace_utils import track_custom_event
from ddtrace import tracer
metadata = {"usr.id": "userid"}
event_name = "users.signup"
track_custom_event(tracer, event_name, metadata)