Skip to content

Commit e841123

Browse files
docs(weave): tighten agent PII redaction notes
1 parent 51ee5db commit e841123

1 file changed

Lines changed: 12 additions & 15 deletions

File tree

AGENTS.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -730,22 +730,19 @@ deterministic.
730730
- An authorized server route may set `pii-v1` from the owning organization's
731731
policy. Never populate the field from caller-controlled OTLP content or a
732732
process environment fallback.
733-
- Agent OTel ingest parses and redacts every span in the request (each shared
734-
resource once) before credential redaction, blob stripping, derived-column
735-
extraction, or insertion starts for any of them. A value nested too deeply
736-
to scan rejects the complete request as `RequestTooLarge` (HTTP 413), and
737-
any other detector failure also fails the whole request, before any Content
738-
file write or insert.
739-
- PII redaction covers span and event names, span, resource, event, and link
740-
attributes, and the status message. Names feed the `span_name`,
741-
`operation_name`, and `agent_name` grouping columns, so a PII-bearing name
742-
changes grouping and agent identity after redaction; keeping PII out of
743-
storage wins over grouping continuity. IDs, trace state, and timestamps are
744-
structural and remain unchanged.
733+
- Agent OTel ingest parses and redacts every span (each shared resource once)
734+
before credential redaction, blob stripping, derived-column extraction, or
735+
insertion starts for any of them. A redaction failure rejects the whole
736+
request before any Content file write or insert; a value nested too deeply
737+
to scan is rejected as `RequestTooLarge` (HTTP 413).
738+
- PII redaction covers span and event names, all four attribute containers,
739+
and the status message. Names feed the `span_name`, `operation_name`, and
740+
`agent_name` grouping columns, so a PII-bearing name changes grouping and
741+
agent identity; redaction wins that trade-off. IDs, trace state, and
742+
timestamps are structural and remain unchanged.
745743
- `pii-v1` scans strings and never decodes payloads: non-string leaves,
746-
including raw bytes values (stored base64-encoded in dumps), pass through
747-
unchanged, the same boundary as preserved data URLs and standalone base64
748-
strings.
744+
including raw bytes (stored base64-encoded in dumps), pass through
745+
unchanged, like the preserved data URLs and standalone base64.
749746

750747
### Credential-shaped fields in agent span columns
751748
- The agents OTel ingest calls `redact_credentials_from_span` before

0 commit comments

Comments
 (0)