First-party signed kind:export plugin cdylib: the request-log WEBHOOK sink (module: request-log-webhook), packaged as a droppable busbar plugin. Drop the signed tarball into plugins/ and name it from an export..module: request-log-webhook block.
| kind | alias | crate | busbar | license |
|---|---|---|---|---|
export |
request-log-webhook |
busbar-export-webhook-plugin |
1.6.0 (pinned in .busbar-ref) |
Apache-2.0 |
busbar-export-webhook is a kind: export busbar plugin. It POSTs each request-log line, as compact
JSON, to the operator's https:// target through the host's connector (the plugin never dials).
Deliveries are fire-and-forget and never retried:
- a non-2xx answer drops that line and warns BUSBAR-7071; a transport failure drops it and warns BUSBAR-7072, as does each line of a batch met by an admission the host could not answer (that failure is also logged once at ERROR, and the next delivery asks again);
- a target the host refuses raises BUSBAR-7070 once at boot and disables the instance until a reload;
- a reload that changes the url or auth header mid-batch drops the batch's remaining lines with BUSBAR-7109, unless the host pins the batch's bindings.
Configured under the request-log-webhook module name (export.<name>.module: request-log-webhook), with these settings: (unknown keys are refused):
| key | default | meaning |
|---|---|---|
url |
required | The webhook target. https:// only; refused by the host when it names a loopback, link-local, private, CGNAT or cloud-metadata host. May be a secret reference ({env:}, {file:}, {module:}) when it carries a credential. |
auth_header |
none | { name, value }: one header sent on every delivery. Prefer a secret reference ({env:}, {file:}, {module:}) for value; the export host also preserves existing literal header values. |
max_inflight_deliveries |
64 | Concurrent deliveries for this instance; each instance must be at least 1 and must not exceed usize::MAX >> 3. |
delivery_timeout_secs |
2 | Per-delivery deadline in seconds, from 1 up to 30 years (946080000). |
Security notes:
- Only
https://targets are dialled, to public destinations. - A
user:pass@in the url is not sent in the url: it becomes anAuthorization: Basicheader. - An ambiguous url is refused: an
@after the host (a credential holding an unescaped/,?or#) would be dialled as a host. Percent-encode the credential. - An
auth_headerthat cannot be sent (an invalid name or value) is refused, as is one named for a framing or connection field (content-length,transfer-encoding,host,connection,te,upgrade,trailer,keep-alive,proxy-connection);validate,open,refreshandcheckrefuse alike. - Log lines name the target by scheme, a masked userinfo marker (
***@), host and port, with a path shown as/***and a query as?***, and cut the url's parts and the request's credentials from the host's failure text.
-
Each instance must set
max_inflight_deliveriesto at least 1. A positive sibling no longer makes a zero value valid. The one-shot configuration migration changes historical zero values to their effective delivery limit of 1 and reports the correction; rerunning migration leaves the result unchanged. -
Target-admission diagnostics name
settings.urlin the exporter's log context and preserve the host's scrubbed refusal reason. -
A mistyped
auth_header(a string where{ name, value }belongs) or an unknown key under it is refused without quoting the text: the refusal readsinvalid type: string "***"orunknown field `***`. 1.5.5 (serde's derived reader,crates/busbar/src/config/mod.rs:3499) quoted it, and that text is most often the credential. -
An
auth_headerwhose name or value cannot be built as an HTTP header is refused at validation and open (and removed by the migration from 1.5.5). 1.5.5 (crates/busbar/src/export/webhook.rs:148) left such a header out and POSTed every line without it, unauthenticated. -
An
auth_headernamed for a framing or connection field (content-length,host,connection, ...) is refused at validation and open (and removed by the migration from 1.5.5): the sink's framer states those fields itself. 1.5.5 (crates/busbar/src/export/webhook.rs:148) passed such a name to its HTTP client.
cargo build --release -p busbar-export-webhook-plugin --features dropped-incargo test --workspace --lockedApache-2.0. See LICENSE.