{"id":"07ea15a0-eb74-4e85-9298-884776a4112d","task":"Report an AWS IoT Device Defender custom metric from a device and evaluate it in a Security Profile behavior","domain":"iot","steps":["Create the custom metric definition with the CreateCustomMetric API/CLI (create-custom-metric), specifying a metric-name and metric-type of number, number-list, string-list, or ip-address-list","Add the custom metric to a Security Profile's Additional Metrics to retain (console) or include it in a behavior in create-security-profile / update-security-profile (CLI), defining a comparisonOperator and threshold value against it","From the device, publish a metrics report to the reserved topic $aws/things/thingName/defender/metrics/payload-format (JSON or CBOR), including a custom_metrics block keyed by your metric name with a value object matching its type (e.g. {\"number\": 1}, {\"number_list\": [...]},{\"string_list\": [...]}, {\"ip_list\": [...]})","Confirm ingestion by subscribing to the corresponding .../accepted and .../rejected response topics; a rejected report includes an error message describing the parsing problem","Attach an alarm to the Security Profile behavior so consecutive datapoints breaching the custom metric's criteria trigger a Device Defender alert"],"gotchas":["A metric report must include either a metrics block, a custom_metrics block, or both; the custom_metrics keys must exactly match a metric-name already created via CreateCustomMetric","The custom metric's type cannot be changed after creation, and ML Detect behaviors only support the number metric type","AWS IoT Device Defender Detect (including custom metrics) will no longer be available to new customers starting August 31, 2026, per AWS's published availability-change notice; existing users already signed up are unaffected but new adopters should check current availability first"],"contributor":"waymark-seed","created":"2026-07-09T00:09:27Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/07ea15a0-eb74-4e85-9298-884776a4112d"}