Skip to content

Latest commit

 

History

History
175 lines (133 loc) · 12.1 KB

verbose_debugging_reports.md

File metadata and controls

175 lines (133 loc) · 12.1 KB

Verbose Debugging Reports

This document is a collection of verbose debugging reports that are supported.

Source debugging reports

Here are the debugging reports supported for attribution source registrations.

source-destination-limit

A source is rejected due to the destination limit.

source-noised

Noise is applied to a source event.

source-storage-limit

A source is rejected due to the storage limit.

source-success

A source is successfully registered. Note that this is also sent when a source is rejected due to the following limits to mitigate security concerns:

source-destination-rate-limit

A source is rejected due to the destinations per source and reporting site rate limit.

source-destination-per-day-rate-limit

A source is rejected due to the destinations per source and reporting site per day rate limit.

source-unknown-error

System error.

source-channel-capacity-limit

A source is rejected due to exceeding the channel-capacity limit.

source-trigger-state-cardinality-limit

A source is rejected due to exceeding the max trigger-state cardinality.

source-reporting-origin-per-site-limit

A source is rejected due to the reporting origins per source and reporting site limit.

Trigger debugging reports

Here are the debugging reports supported for attribution trigger registrations.

trigger-no-matching-source

A trigger is rejected due to no matching sources in storage that match <reporting origin, destination site> (see algorithm).

trigger-no-matching-filter-data

A trigger is rejected due to no matching filter data.

trigger-event-attributions-per-source-destination-limit

An event-level attribution is rejected due to the max attributions rate limit.

trigger-aggregate-attributions-per-source-destination-limit

An aggregatable attribution is rejected due to the max attributions rate limit.

trigger-reporting-origin-limit

A trigger is rejected due to the attributed reporting origin limit.

trigger-event-deduplicated

An event-level report is not created due to deduplication.

trigger-event-no-matching-configurations

An event-level report is not created due to no matching event triggers.

trigger-event-noise

An event-level report is dropped due to the noise applied to the source.

trigger-event-low-priority

An event-level report is dropped due to too low priority.

trigger-event-excessive-reports

An event-level report is dropped as the maximum number of reports have been scheduled for the source.

trigger-event-storage-limit

An event-level report is not created due to the storage limit.

trigger-event-report-window-not-started

An event-level report is not created as the report window has not started.

trigger-event-report-window-passed

An event-level report is not created as the report window has passed.

trigger-aggregate-deduplicated

An aggregatable report is not created due to deduplication.

trigger-aggregate-no-contributions

An aggregatable report is not created as no histogram contributions are created.

trigger-aggregate-excessive-reports

An aggregatable report is dropped as the maximum number of reports have been scheduled for the source.

trigger-aggregate-insufficient-budget

An aggregatable report is dropped due to insufficient budget.

trigger-aggregate-storage-limit

An aggregatable report is not created due to the storage limit.

trigger-aggregate-report-window-passed

An aggregatable report is not created as the report window has passed.

trigger-unknown-error

System error.

Report data

The report data is included in the request body as a JSON list of objects, and each object has a string field type and a dictionary field body, e.g.:

[{
  "type": "source-destination-limit",
  "body": {
    "attribution_destination": "https://destination.example",
    "limit": "100",
    "source_debug_key": "1234567890",
    "source_event_id": "12340873456",
    "source_site": "https://source.example"
  }
}]

The body field is identical to the event-level report body if type is trigger-event-low-priority or trigger-event-excessive-reports, otherwise the dictionary may include the following fields:

  • attribution_destination: The site on which attribution did/would occur, e.g. "https://destination.example".
  • limit: The browser's limit enforced, e.g. "100".
  • source_debug_key: The debug key in the source registration, omitted if not set.
  • source_event_id: The source event id in the source registration.
  • source_site: The site on which source was registered, e.g. "https://source.example".
  • trigger_debug_key: The debug key in the trigger registration, omitted if not set.

If type is source-success or source-noised, the body dictionary may include a source_destination_limit field if the destination limit was exceeded.

This table defines the fields in the body dictionary.

type attribution_destination limit source_debug_key source_event_id source_site trigger_debug_key source_destination_limit
source-channel-capacity-limit
source-destination-limit
source-destination-per-day-rate-limit
source-destination-rate-limit
source-noised
source-reporting-origin-per-site-limit
source-storage-limit
source-success
source-trigger-state-cardinality-limit
source-unknown-error
trigger-no-matching-source
trigger-no-matching-filter-data
trigger-event-attributions-per-source-destination-limit
trigger-aggregate-attributions-per-source-destination-limit
trigger-reporting-origin-limit
trigger-event-deduplicated
trigger-event-no-matching-configurations
trigger-event-noise
trigger-event-storage-limit
trigger-event-report-window-not-started
trigger-event-report-window-passed
trigger-aggregate-deduplicated
trigger-aggregate-excessive-reports
trigger-aggregate-no-contributions
trigger-aggregate-insufficient-budget
trigger-aggregate-storage-limit
trigger-aggregate-report-window-passed
trigger-unknown-error