README.md

⚡ MetaTrace

Quickstart

Docker

docker run ghcr.io/dioptra-io/metatrace --help

Python

pip install metatrace
metatrace --help

Repository

git clone [email protected]:dioptra-io/metatrace.git
cd metatrace
poetry install
poetry run metatrace --help

Usage

CLI

Data

metatrace data create|delete|get|insert|query

Metadata

metatrace METADATA create|delete|get|query

For example:

metatrace asn add --collector route-views2.routeviews.org --date 2014-01-01T00:00:00
metatrace asn get
# ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┓
# ┃ Identifier        ┃ Collector                   ┃ Date                     ┃ Creation date            ┃ Rows   ┃ Size                  ┃
# ┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━┩
# │ 202205312208_1f59 │ route-views2.routeviews.org │ Wed Jan  1 00:00:00 2014 │ Tue May 31 22:08:18 2022 │ 498110 │ 3.5454529999999997 MB │
# └───────────────────┴─────────────────────────────┴──────────────────────────┴──────────────────────────┴────────┴───────────────────────┘
metatrace asn query 202205312208_1f59 8.8.8.8
# 15169
metatrace asn delete 202205312208_1f59

Web

metatrace server

http://localhost:5555

Python

metatrace.lib

Data

Public CAIDA Ark data is supported.

Metadata

Autonomous system number

This metadata maps an IP address to its originating AS number, as seen by a BGP collector. RouteViews and RIPE RIS are supported.

Geolocation

This metadata maps an IP address to its country, city, latitude and longitude. MaxMind GeoLite2 City is supported.

Internet Exchange Point

This metadata maps an IP address to its IXP if it belongs to its peering LAN. PeeringDB is supported.

Authors

MetaTrace is developed and maintained by the Dioptra group at Sorbonne Université in Paris, France.