Overview
The GeoIP node performs a lookup of location or ASN (Autonomous System Number) information based on a given IP address. It is useful for scenarios where you need to enrich data with geographical or network-related details, such as identifying the country, city, or ISP associated with an IP address. Practical examples include enhancing logs with location data, customizing content based on user location, or analyzing network traffic sources.
Use Case Examples
- Lookup the geographical location of an IP address to display user location on a map.
- Retrieve ASN information to identify the ISP or organization owning an IP address for network analysis.
Properties
| Name | Meaning |
|---|---|
| IP | The IP address to lookup, required for the node to perform the GeoIP query. |
| Simplify | Whether to return a simplified version of the response instead of the raw data, making it easier to use in workflows. |
| Options | Additional options to customize the lookup output. |
Output
JSON
ip- The IP address that was looked up.location- Location information related to the IP address, such as country, city, and coordinates.asn- Autonomous System Number information related to the IP address, such as ASN number and organization.
Dependencies
- Requires an API key credential or authentication token to access the GeoIP service.
Troubleshooting
- Ensure the IP address provided is valid and correctly formatted; invalid IPs will cause lookup failures.
- If the node returns raw data and it is difficult to parse, enable the 'Simplify' option for easier output.
- Check that the API key or authentication credentials are correctly configured and have sufficient permissions.
- If location names are not displaying in the selected language, verify the language option is set correctly and supported by the service.
Links
- IPInfo API Documentation - Documentation for a common GeoIP service API that might be used by the node.
- Geolocation Wikipedia - General information about geolocation and IP-based location services.