Envío
Después de instalar DogStatsD, puedes emitir eventos al Datadog Event Explorer con la siguiente función:
event(<title>, <message>, <alert_type>, <aggregation_key>, <source_type_name>, <date_happened>, <priority>, <tags>, <hostname>)
Definiciones:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
<title> | Cadena | Sí | El título del evento |
<message> | Cadena | Sí | El cuerpo del texto del evento |
<alert_type> | Cadena | No | error, warning, success o info (por defecto info) |
<aggregation_key> | Cadena | No | Una clave para agregar eventos |
<source_type_name> | Cadena | No | El nombre del tipo de fuente (por defecto my_apps) |
<date_happened> | Entero | No | La marca de tiempo de la época del evento (por defecto es la hora actual del servidor de DogStatsD) |
<priority> | Cadena | No | Especifica la prioridad del evento (normal o low) |
<tags> | Lista de cadenas | No | Un lista de etiquetas asociadas a este evento |
<hostname> | Cadena | No | El nombre del host |
Ejemplos
Ejecuta el siguiente código para ver errores y excepciones en Datadog con un evento de DogStatsD. Recuerda flush/close el cliente cuando ya no sea necesario.
from datadog import initialize, statsd
options = {
'statsd_host':'127.0.0.1',
'statsd_port':8125
}
initialize(**options)
statsd.event('An error occurred', 'Error message', alert_type='error', tags=['env:dev'])
require 'datadog/statsd'
statsd = Datadog::Statsd.new('localhost', 8125)
statsd.event('An error occurred', "Error message", alert_type: 'error', tags: ['env:dev'])
package main
import (
"log"
"time"
"github.com/DataDog/datadog-go/statsd"
)
func main() {
dogstatsdClient, err := statsd.New("127.0.0.1:8125")
if err != nil {
log.Fatal(err)
}
for {
dogstatsdClient.SimpleEvent("An error occurred", "Error message")
time.Sleep(10 * time.Second)
}
}
import com.timgroup.statsd.Event;
import com.timgroup.statsd.NonBlockingStatsDClientBuilder;
import com.timgroup.statsd.StatsDClient;
public class DogStatsdClient {
public static void main(String[] args) throws Exception {
StatsDClient Statsd = new NonBlockingStatsDClientBuilder()
.prefix("statsd").
.hostname("localhost")
.port(8125)
.build();
Event event = Event.builder()
.withTitle("An error occurred")
.withText("Error message")
.withAlertType(Event.AlertType.ERROR)
.build();
Statsd.recordEvent(event);
}
}
using StatsdClient;
public class DogStatsdClient
{
public static void Main()
{
var dogstatsdConfig = new StatsdConfig
{
StatsdServerName = "127.0.0.1",
StatsdPort = 8125,
};
using (var dogStatsdService = new DogStatsdService())
{
if (!dogStatsdService.Configure(dogstatsdConfig))
throw new InvalidOperationException("Cannot initialize DogstatsD. Set optionalExceptionHandler argument in the `Configure` method for more information.");
dogStatsdService.Event("An error occurred", "Error message", alertType: "error", date_happened='TIMESTAMP', tags: new[] { "env:dev" });
}
}
}
<?php
require __DIR__ . '/vendor/autoload.php';
use DataDog\DogStatsd;
$statsd = new DogStatsd(
array('host' => '127.0.0.1',
'port' => 8125,
)
);
$statsd->event('An error occurred.',
array( 'text' => 'Error message',
'alert_type' => 'error'
)
);
Con la biblioteca de DogStatsD-PHP puedes enviar eventos a través de TCP directamente a la API de Datadog. Es más lento pero más fiable que utilizar la instancia de DogStatsD del Agent, ya que los eventos se reenvían desde tu aplicación al Agent mediante UDP.
Para utilizarlo, debes configurar la biblioteca con tus claves de aplicación y API de Datadog en lugar de la instancia local de DogStatS:
<?php
require __DIR__ . '/vendor/autoload.php';
use DataDog\DogStatsd;
$statsd = new DogStatsd(
array('api_key' => '<DATADOG_API_KEY>',
'app_key' => '<DATADOG_APPLICATION_KEY>',
)
);
$statsd->event('An error occurred.',
array( 'text' => 'Error message',
'alert_type' => 'error'
)
);
Nota:
- El envío de eventos mediante este método utiliza cURL para las solicitudes de API.
- Debes utilizar un bloque de código
try/catch para evitar advertencias o errores sobre problemas de comunicación con la API de Datadog.
Lectura adicional
Más enlaces, artículos y documentación útiles:
