Ranked leaderboard over a time window: the top source addresses, networks,
countries, destination ports, user agents, JA4 fingerprints, URL paths, reverse
DNS domains or CVEs by event count.
Use for "who is attacking the most", "top countries hitting port 22", "most
targeted ports this week", "top networks by volume", and with by='cve' for
"which CVEs are being scanned for right now". Do not use it for one known
address (use ioc_lookup_tool), one known network (use asn_enrich_tool), one
known CVE (use cve_lookup_tool), or a trend over time (use
attack_timeline_tool).
by: ip, asn, country, port, user_agent, ja4, url_path, domain or cve (default
ip). limit is 1 to 100, default 20. Optional filters country (ISO code),
dest_port and asn ('AS12345'); add one when the window is long, because an
unfiltered ranking over many days can hit the query memory limit. by='cve'
takes no filters and returns value (the CVE id), title, severity,
actively_exploited (on the CISA KEV catalogue), kev_date_added and counts.
since and until are ISO-8601 UTC, within the plan's query window.