Hooks and logger¶
Hooks¶
Hooks observe every HTTP attempt (retries included) for metrics, auditing or debugging. All
data they receive is already redacted: sensitive headers show [REDACTED] and the URL has its
sensitive query values redacted. An exception thrown by a hook is caught and ignored, so hooks can
never break a call.
| Hook | Data |
|---|---|
onRequest |
RequestInfo { method, url, headers, attempt } (attempt starts at 1) |
onResponse |
ResponseInfo { method, url, status, durationMs, attempt, requestId? } |
onError |
ErrorInfo { method, url, error, attempt, willRetry } |
use std::sync::Arc;
use grow_datadog_logs::core::{ErrorInfo, Hooks, RequestInfo, ResponseInfo};
struct Metrics;
impl Hooks for Metrics {
fn on_request(&self, r: &RequestInfo) {
println!("-> {} {} attempt {}", r.method, r.url, r.attempt);
}
fn on_response(&self, r: &ResponseInfo) {
println!("<- {} in {:?}", r.status, r.duration);
}
fn on_error(&self, e: &ErrorInfo) {
eprintln!("{:?} will_retry={}", e.error.code(), e.will_retry);
}
}
let config = DatadogLogsConfig::builder().hooks(Arc::new(Metrics)).build()?;
cfg := datadoglogs.Config{CommonConfig: datadoglogs.CommonConfig{
Hooks: &datadoglogs.Hooks{
OnRequest: func(r datadoglogs.RequestInfo) { log.Printf("-> %s %s attempt %d", r.Method, r.URL, r.Attempt) },
OnResponse: func(r datadoglogs.ResponseInfo) { log.Printf("<- %d in %s", r.Status, r.Duration) },
OnError: func(e datadoglogs.ErrorInfo) { log.Printf("%v willRetry=%t", e.Err, e.WillRetry) },
},
}}
from grow_datadog_logs import Hooks, DatadogLogsConfig
config = DatadogLogsConfig(
hooks=Hooks(
on_request=lambda r: print("->", r.method, r.url, "attempt", r.attempt),
on_response=lambda r: print("<-", r.status, r.duration_ms),
on_error=lambda e: print(type(e.error).__name__, "will_retry", e.will_retry),
)
)
Hooks hooks = new Hooks() {
@Override public void onRequest(Hooks.RequestInfo r) {
System.out.println("-> " + r.method() + " " + r.url() + " attempt " + r.attempt());
}
@Override public void onResponse(Hooks.ResponseInfo r) {
System.out.println("<- " + r.status() + " in " + r.durationMs() + " ms");
}
@Override public void onError(Hooks.ErrorInfo e) {
System.out.println(e.error().code() + " willRetry=" + e.willRetry());
}
};
DatadogLogsConfig config = DatadogLogsConfig.builder().hooks(hooks).build();
Logger¶
The client writes diagnostic messages (retries, TLS warnings, closed resources) to a logger. It is silent by default and never logs secrets.
| Language | Default | How to enable |
|---|---|---|
| TypeScript | silent | logger: { debug, info, warn, error } in the config (for example console) |
| Rust | tracing events at debug |
install a tracing subscriber in your application |
| Go | *slog.Logger that discards |
CommonConfig.Logger: slog.Default() |
| Python | logging.getLogger("grow_datadog_logs") with a NullHandler |
configure the grow_datadog_logs logger, or pass logger= |
| Java | no-op (no SLF4J dependency) | .logger(...) with an implementation of codes.grow.packages.datadoglogs.core.Logger |