import datadog.trace.api.Trace

public class BackupLedger {

  // @Trace 주석을 사용해 커스텀 메서드 추적
  @Trace
  public void write(List<Transaction> transactions) {
    for (Transaction transaction : transactions) {
      ledger.put(transaction.getId(), transaction);
    }

    // [...]
  }
}

import datadog.trace.api.Trace;
import io.opentracing.Scope;
import io.opentracing.Tracer;
import io.opentracing.util.GlobalTracer;

public class BackupLedger {

  // `@Trace` 주석을 사용해 커스텀 메서드 추적
  @Trace
  public void write(List<Transaction> transactions) {
    for (Transaction transaction : transactions) {
      // `GlobalTracer`를 사용해 인라인 코드 블록 추적
      Tracer tracer = GlobalTracer.get();
      // 참고: 아래 리소스 try 블록 범위는
      // 코드 블록 마지막에 자동으로 종료됩니다.
      // 리소스 문이 있는 try 블록을 사용하지 않을 경우
      // scope.close()를 호출해야 합니다.
      try (Scope scope = tracer.buildSpan("BackupLedger.persist").startActive(true)) {
        // Add custom metadata to the span
        scope.span().setTag("transaction.id", transaction.getId());
        ledger.put(transaction.getId(), transaction);
      }
    }

    // [...]
  }
}

from ddtrace import tracer

class BackupLedger:

    # `tracer.wrap` 장식자를 사용해 커스텀 메서드를 추적
    @tracer.wrap()
    def write(self, transactions):
        for transaction in transactions:
            self.ledger[transaction.id] = transaction

        # [...]

from ddtrace import tracer

class BackupLedger:

    # `tracer.wrap` 장식자를 사용해 커스텀 메서드 추적
    @tracer.wrap()
    def write(self, transactions):
        for transaction in transactions:
            # `tracer.trace` 컨텍스트 매니저를 사용해 인라인 코드 블록 추적
            with tracer.trace('BackupLedger.persist') as span:
                # "persist_transaction" 스팬에 커스텀 메타데이터 추가
                span.set_tag('transaction.id', transaction.id)
                self.ledger[transaction.id] = transaction

        # [...]

require 'ddtrace'

class BackupLedger

  def write(transactions)
    # 인라인 코드 블록을 추적할 때 전역 `Datadog::Tracing.trace`을 사용
    Datadog::Tracing.trace('BackupLedger.write') do |method_span|
      transactions.each do |transaction|
        Datadog::Tracing.trace('BackupLedger.persist') do |span|
          # "persist_transaction" 스팬에 커스텀 메타 데이터 추가
          span.set_tag('transaction.id', transaction.id)
          ledger[transaction.id] = transaction
        end
      end
    end

    # [...]
  end
end

package ledger

import "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"

// [...]

func (bl *BackupLedger) write(ctx context.Context, transactions []*Transaction) (err error) {
  // `write` 함수를 추적하고 오류가 있으면 캡처
  span, ctx := tracer.StartSpanFromContext(ctx, "BackupLedger.write")
  defer func() {
    span.Finish(tracer.WithError(err))
  }()

  for _, t := range transactions {
    if err := bl.persistTransaction(ctx, t); err != nil {
      return err
    }
  }
  return nil
}

// persistTransaction는 추적해야 하는 내부 함수임.
// 전달한 `ctx`에 기본 스팬이 포함되어 있기 때문에 이전과 동일한 방법을 사용할 수 있음.
// 상위/하위 관계 생성 참조.
func (bl *BackupLedger) persistTransaction(ctx context.Context, transaction *Transaction) error {
  id := transaction.ID
  span, _ := tracer.StartSpanFromContext(ctx, "BackupLedger.persist", tracer.Tag("transaction_id", id))
  defer span.Finish()

  if t, ok := bl.transactions[id]; ok {
    return errors.New("duplicate entry")
  }
  bl.transactions[id] = transaction
  return nil
}

const tracer = require('dd-trace')

function write (transactions) {
  // 인라인 코드 블록을 추적할 때 `tracer.trace` 컨텍스트 매니저를 사용
  tracer.trace('BackupLedger.write', () => {
    for (const transaction of transactions) {
      tracer.trace('BackupLedger.persist' , (span) => {
        // "persist_transaction" 스팬에 커스텀 메타데이터 추가
        span.setTag('transaction.id', transaction.id)
        this.ledger[transaction.id] = transaction
      })
    }
  })

  // [...]
}

using Datadog.Trace;

public void Write(List<Transaction> transactions)
{
    // 인라인 코드 블록을 추적할 때 전역 추적 사용
    using (var scope = Tracer.Instance.StartActive("BackupLedger.write"))
    {
        foreach (var transaction in transactions)
        {
            using (var scope = Tracer.Instance.StartActive("BackupLedger.persist"))
            {
                // 스팬에 커스텀 메타데이터 추가
                scope.Span.SetTag("transaction.id", transaction.Id);
                this.ledger[transaction.Id] = transaction;
            }
        }
    }

    // [...]
}

<?php
  class BackupLedger {

    public function write(array $transactions) {
      foreach ($transactions as $transaction) {
        $this->transactions[$transaction->getId()] = $transaction;
      }

      # [...]
    }
  }

  // ddtrace < v0.47.0의 경우 \dd_trace_method() 사용
  \DDTrace\trace_method('BackupLedger', 'write', function (\DDTrace\SpanData $span) {
    //  (>= v0.47.0)이 아니면 SpanData::$name 기본값이 'ClassName.methodName'이 됨
    $span->name = 'BackupLedger.write';
    // (>= v0.47.0)가 아니면 SpanData::$resource 기본값이 SpanData::$name이 됨
    $span->resource = 'BackupLedger.write';
    $span->service = 'php';
  });
?>

<?php
  class BackupLedger {

    public function write(array $transactions) {
      foreach ($transactions as $transaction) {
        // 인라인 코드 블록을 추적할 때 전역 추적을 사용
        $span = \DDTrace\start_span();
        $span->name = 'BackupLedger.persist';

        // 스팬에 커스텀 메타데이터 추가
        $span->meta['transaction.id'] = $transaction->getId();
        $this->transactions[$transaction->getId()] = $transaction;

        // 스팬 닫기
        \DDTrace\close_span();
      }

      # [...]
    }
  }

  // ddtrace < v0.47.0의 경우 \dd_trace_method() 사용
  \DDTrace\trace_method('BackupLedger', 'write', function (\DDTrace\SpanData $span) {
    // (>= v0.47.0)이 아니면 SpanData::$name 기본값이 'ClassName.methodName'이 됨
    $span->name = 'BackupLedger.write';
    // (>= v0.47.0)이 아니면 SpanData::$resource 기본값이 SpanData::$name이 됨
    $span->resource = 'BackupLedger.write';
    $span->service = 'php';
  });
?>