このページは日本語には対応しておりません。随時翻訳に取り組んでいます。
翻訳に関してご質問やご意見ございましたら、
お気軽にご連絡ください。
Overview
The geoIP parser takes an IP address attribute and extracts continent, country, subdivision, or city information (if available) in the target attribute path.
Most elements contain a name and iso_code (or code for continent) attribute. subdivision is the first level of subdivision that the country uses such as “States” for the United States or “Departments” for France.
For example, the geoIP parser extracts location from the network.client.ip attribute and stores it into the network.client.geoip attribute:
Use cases
The most common use case is detecting the location of a specific user. For example, the GeoIP Parser is used for iOS logs to provide the location of the user identified in the logs.
Before and after state of logs
Before:
{
"network": {
"client": {
"ip": "203.0.113.42"
}
},
"http": {
"method": "GET",
"url": "/checkout",
"status_code": 200
}
}
GeoIP Parser
Create a GeoIP Parser with source attribute network.client.ip and a target root attribute: network.client.geoip.
After processing:
{
"network": {
"client": {
"ip": "203.0.113.42",
"geoip": {
"country": {
"iso_code": "US",
"name": "United States"
},
"city": {
"name": "New York"
},
"location": {
"lat": 40.7128,
"lon": -74.0060
}
}
}
},
"http": {
"method": "GET",
"url": "/checkout",
"status_code": 200
}
}
API
Use the Datadog Log Pipeline API endpoint with the following geoIP parser JSON payload:
{
"type": "geo-ip-parser",
"name": "Parse the geolocation elements from network.client.ip attribute.",
"is_enabled": true,
"sources": ["network.client.ip"],
"target": "network.client.geoip"
}
| Parameter | Type | Required | Description |
|---|
type | String | Yes | Type of the processor. |
name | String | No | Name of the processor. |
is_enabled | Boolean | No | If the processor is enabled or not. Default: false. |
sources | Array of strings | No | Array of source attributes. Default: network.client.ip. |
target | String | Yes | Name of the parent attribute that contains all the extracted details from the sources. Default: network.client.geoip. |
Further reading
