IPinfo Lite
Country, continent and autonomous system for public IPs, written to OCSF endpoint attributes at ingest.
Use IPinfo Lite to add country, continent, and autonomous-system context to public IPs in your events. ClickHouse looks up src_endpoint.ip and dst_endpoint.ip at ingest in a local copy of IPinfo's free IP-to-country-and-ASN dataset.
Lookups fill standard OCSF location and autonomous-system attributes. They make no per-lookup API call and have no rate limit.
What it writes
For a public IP that's in the database, nano fills these attributes on the matching endpoint. It only fills an attribute the event doesn't already have, so values from the source log win.
| Path | Example |
|---|---|
src_endpoint.location.country | US (ISO 3166-1 alpha-2) |
src_endpoint.location.continent | North America |
src_endpoint.autonomous_system.number | 15169 |
src_endpoint.autonomous_system.name | Google LLC |
The same paths exist under dst_endpoint. Private, loopback and other non-public addresses aren't enriched.
Search examples
Top source countries:
src_endpoint.location.country=* | stats count by src_endpoint.location.country | sort -count | head 10Successful logins from outside your usual countries:
class_uid=3002 status_id=1 src_endpoint.location.country=* src_endpoint.location.country!="US" | stats count, dc(src_endpoint.ip) as ips by user.name, src_endpoint.location.countryOutbound traffic by destination network owner:
class_uid=4001 dst_endpoint.autonomous_system.name=* | stats sum(traffic.bytes_out) as bytes by dst_endpoint.autonomous_system.name | sort -bytes | head 20How it's delivered
IPinfo Lite is part of nano's signed platform feed bundle, on open core and Self-run alike. You don't need an IPinfo account or token: nano fetches the dataset, signs it into the bundle, and your install loads it into ClickHouse's IP dictionary.
Marketplace shows the feed's state (fresh, stale or expired) and when the bundle was installed. A feed older than 7 days is shown as stale but still used; an expired feed no longer stamps new events.
To look up a single IP, call GET /api/enrichment/lookup/{ip}.
Troubleshoot
Need help with these checks? Contact support with the request ID and time with timezone.
A public IP has no location
Check that the event has src_endpoint.ip or dst_endpoint.ip and that the IP is in the database. nano does not replace attributes already set by the parser. Then check the feed state and ClickHouse memory; see the IPinfo checks.