En Java, la APM Datadog te permite instrumentar tu código para generar tramos personalizados, ya sea utilizando decoradores de métodos o instrumentando bloques de código específicos.
Instument a method with a decorator (Instrumentar un método con un decorador):
Este ejemplo añade un tramo al método BackupLedger.write, que añade nuevas filas a un libro de contabilidad de transacciones. Se añade un tramo para rastrear todas las transacciones contabilizadas como una sola unidad.
import datadog.trace.api.Trace
public class BackupLedger {
// Utiliza la anotación @Trace para rastrear métodos personalizados
@Trace
public void write(List<Transaction> transactions) {
for (Transaction transaction : transactions) {
ledger.put(transaction.getId(), transaction);
}
// [...]
}
}
Instrument a specific code block (Instrumentar un bloque de código específico):
Este ejemplo añade tramos secundarios al tramo BackupLedger.write creado anteriormente. Este método añade un tramo secundario para cada transacción en el libro de contabilidad y una etiqueta (tag) personalizada con el ID de transacción específico.
import datadog.trace.api.Trace;
import io.opentracing.Scope;
import io.opentracing.Tracer;
import io.opentracing.util.GlobalTracer;
public class BackupLedger {
// Utiliza la anotación `@Trace` para rastrear métodos personalizados
@Trace
public void write(List<Transaction> transactions) {
para (Transaction transaction : transactions) {
// Utiliza `GlobalTracer` para rastrear bloques del código insertado
Tracer tracer = GlobalTracer.get();
// Nota: El ámbito en el siguiente bloque intentar con el recurso
// se cerrará automáticamente al final del bloque de código.
// Si no utilizas una instrucción probar con el recurso, deberás
// llamar a scope.close().
prueba (Scope scope = tracer.buildSpan("BackupLedger.persist").startActive(true)) {
// Añade metadatos personalizados al tramo
scope.span().setTag("transaction.id", transaction.getId());
ledger.put(transaction.getId(), transaction);
}
}
// [...]
}
}
En Python, la APM Datadog te permite instrumentar tu código para generar tramos personalizados, ya sea utilizando decoradores de métodos o instrumentando bloques de código específicos.
Instument a method with a decorator (Instrumentar un método con un decorador):
Este ejemplo añade un tramo al método BackupLedger.write, que añade nuevas filas a un libro de contabilidad de transacciones. Se añade un tramo para rastrear todas las transacciones contabilizadas como una sola unidad.
from ddtrace import tracer
class BackupLedger:
# Utiliza el decorador `tracer.wrap` para rastrear métodos personalizados
@tracer.wrap()
def write(self, transactions):
para una transacción en transacciones:
self.ledger[transaction.id] = transaction
# [...]
Instrument a specific code block (Instrumentar un bloque de código específico):
Este ejemplo añade tramos secundarios al tramo BackupLedger.write creado anteriormente. Este método añade un tramo secundario para cada transacción en el libro de contabilidad y una etiqueta (tag) personalizada con el ID de transacción específico.
from ddtrace import tracer
class BackupLedger:
# Utiliza el decorador `tracer.wrap` para rastrear métodos personalizados
@tracer.wrap()
def write(self, transactions):
para la transacción en transacciones:
# Utiliza el administrador del contexto `tracer.trace` para rastrear bloques del código insertado
con el tramo tracer.trace('BackupLedger.persist'):
# Añade metadatos personalizados al tramo "persist_transaction"
span.set_tag('transaction.id', transaction.id)
self.ledger[transaction.id] = transaction
# [...]
En Ruby, la APM Datadog te permite instrumentar tu código para generar tramos personalizados instrumentando bloques de código específicos.
Este ejemplo crea un nuevo tramo para la llamada al método BackupLedger.write y un tramo secundario para cada transacción contabilizada en el libro de contabilidad con una etiqueta personalizada con el ID de transacción específico.
require 'ddtrace'
class BackupLedger
def write(transactions)
# Utiliza `Datadog::Tracing.trace` global para rastrear bloques del código insertado
Datadog::Tracing.trace('BackupLedger.write') do |method_span|
transactions.each do |transaction|
Datadog::Tracing.trace('BackupLedger.persist') do |span|
# Añade metadatos personalizados al tramo "persist_transaction"
span.set_tag('transaction.id', transaction.id)
ledger[transaction.id] = transaction
end
end
end
# [...]
end
end
En Go, la APM Datadog te permite instrumentar tu código para generar tramos personalizados instrumentando bloques de código específicos.
Este ejemplo crea un nuevo tramo para cada transacción contabilizada en el libro de contabilidad y añade una etiqueta personalizada con el ID de transacción específico al tramo.
Note: This documentation uses v2 of the Go tracer, which Datadog recommends for all users. If you are using v1, see the migration guide to upgrade to v2.
package ledger
import (
"github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
)
// [...]
func (bl *BackupLedger) write(ctx context.Context, transactions []*Transaction) (err error) {
// Trace the `write` function and capture the error if present
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 is an inner function you may want to Trace. You can use the
// same approach as before because the `ctx` you pass down includes out-of-the-box span
// references to create a parent/child relationships.
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
}
En Node.js, la APM Datadog te permite instrumentar tu código para generar tramos personalizados instrumentando bloques de código específicos.
Este ejemplo crea un nuevo tramo para la llamada al método BackupLedger.write y un tramo secundario para cada transacción contabilizada en el libro de contabilidad con una etiqueta personalizada con el ID de transacción específico.
const tracer = require('dd-trace')
function write (transactions) {
// Utiliza el administrador de contexto `tracer.trace` para rastrear bloques del código insertado
tracer.trace('BackupLedger.write', () => {
para (const transaction of transactions) {
tracer.trace('BackupLedger.persist' , (span) => {
// Añade metadatos personalizados al tramo "persist_transaction"
span.setTag('transaction.id', transaction.id)
this.ledger[transaction.id] = transaction
})
}
})
// [...]
}
En .NET, la APM Datadog te permite instrumentar tu código para generar tramos personalizados instrumentando bloques de código específicos.
Este ejemplo crea un nuevo tramo para cada transacción contabilizada en el libro de contabilidad y añade una etiqueta personalizada con el ID de transacción específico al tramo.
using Datadog.Trace;
public void Write(List<Transaction> transactions)
{
// Utiliza el rastreador global para rastrear bloques del código insertado
utilizando (var scope = Tracer.Instance.StartActive("BackupLedger.write"))
{
foreach (var transaction in transactions)
{
utilizando (var scope = Tracer.Instance.StartActive("BackupLedger.persist"))
{
// Añade metadatos personalizados al tramo
scope.Span.SetTag("transaction.id", transaction.Id);
this.ledger[transaction.Id] = transaction;
}
}
}
// [...]
}
En PHP, la APM Datadog te permite instrumentar tu código para generar tramos personalizados, ya sea utilizando contenedores de métodos o instrumentando bloques de código específicos.
Instrument a method with a wrapper (Instrumentar un método con un contenedor):
Este ejemplo añade un tramo al método BackupLedger.write, que añade nuevas filas a un libro de contabilidad de transacciones. Se añade un tramo para rastrear todas las transacciones contabilizadas como una sola unidad utilizando la función DDTrace\trace_method() .
<?php
class BackupLedger {
public function write(array $transactions) {
foreach ($transactions as $transaction) {
$this->transactions[$transaction->getId()] = $transaction;
}
# [...]
}
}
// For ddtrace < v0.47.0 use \dd_trace_method()
\DDTrace\trace_method('BackupLedger', 'write', function (\DDTrace\SpanData $span) {
// SpanData::$name defaults to 'ClassName.methodName' if not set (>= v0.47.0)
$span->name = 'BackupLedger.write';
// SpanData::$resource defaults to SpanData::$name if not set (>= v0.47.0)
$span->resource = 'BackupLedger.write';
$span->service = 'php';
});
?>
Instrument a specific code block (Instrumentar un bloque de código específico):
Este ejemplo añade tramos secundarios al tramo BackupLedger.write creado anteriormente. Este método añade un tramo secundario para cada transacción en el libro de contabilidad y una etiqueta personalizada con el ID de transacción específico.
<?php
class BackupLedger {
public function write(array $transactions) {
foreach ($transactions as $transaction) {
// Utiliza el rastreador global para rastrear bloques del código insertado
$span = \DDTrace\start_span();
$span->name = 'BackupLedger.persist';
// Añade metadatos personalizados al tramo
$span->meta['transaction.id'] = $transaction->getId();
$this->transactions[$transaction->getId()] = $transaction;
// Cierra el tramo
\DDTrace\close_span();
}
# [...]
}
}
// For ddtrace < v0.47.0 use \dd_trace_method()
\DDTrace\trace_method('BackupLedger', 'write', function (\DDTrace\SpanData $span) {
// SpanData::$name defaults to 'ClassName.methodName' if not set (>= v0.47.0)
$span->name = 'BackupLedger.write';
// SpanData::$resource defaults to SpanData::$name if not set (>= v0.47.0)
$span->resource = 'BackupLedger.write';
$span->service = 'php';
});
?>
