Add Tags to measurement definition about ripe-atlas

[keltia]

Right, not the include/exclude tags you can have for probesets. Adding this to the API is not really difficult, changing the UI on atlas a bit more.

[awlx]

Nice! Thank you so much.

This really helps me to finish my current automated measurements with Atlas project!

[keltia]

Closing this then :)

[keltia]

My documentation may be misleading then because you can include/exclude tags already:

$ atlas -T ipv4 -N 10 ping 8.8.8.8
Measurements created:
15759778

Use the following command to retrieve results in JSON:

  atlas r 

$ atlas r 15759778 | jq .
[
  {
    "af": 4,
    "avg": 2.373305,
    "dst_addr": "8.8.8.8",
    "dst_name": "8.8.8.8",
    "dup": 0,
    "from": "46.182.41.95",
    "fw": 4940,
    "group_id": 15759778,
    "lts": 48,
    "max": 3.89673,
    "min": 1.61028,
    "msm_id": 15759778,
    "msm_name": "Ping",
    "prb_id": 12007,
    "proto": "ICMP",
    "rcvd": 3,
    "result": [
      {
        "rtt": 3.89673
      },
      {
        "rtt": 1.61028
      },
      {
        "rtt": 1.612905
      }
    ],
    "sent": 3,
    "size": 64,
    "src_addr": "192.168.31.153",
    "step": null,
    "stored_timestamp": 1534772351,
    "timestamp": 1534772337,
    "ttl": 121,
    "type": "ping"
  },
...

If you run it in debug mode with -D you see ipv4specified in the tags_include entry in the ProbeSet.

Are you talking of something else?

It was implemented around 2e43065.

[awlx]

We are talking about when creating a measurement it is possible to add a tag to it so it's easier to find.

curl --dump-header - -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d '{
"definitions": [
{
"target": "test.de",
"af": 4,
"packets": 3,
"size": 48,
"description": "Ping measurement to test.de",
"interval": 240,
"tags": [
"test-tag"
],
"resolve_on_probe": false,
"skip_dns_check": false,
"include_probe_id": false,
"type": "ping"
}
],
"probes": [
{
"type": "area",
"value": "WW",
"requested": 10
}
],
"is_oneoff": false,
}' https://atlas.ripe.net/api/v2/measurements//?key=YOUR_KEY_HERE

See the "test-tag" in the request :).

[keltia]

Done in v0.40 (API 0.5.0) in commit 5196456

See https://atlas.ripe.net/api/v2/measurements/15771119/ for an example.

Please try and comment :)

[awlx]

Perfect! Works like a charm :). Thank you very much!

Is it also possible to add the --tags Flag to the measurement search function? It would be really awesome, so we could add new measurements already tagged with all flags we want and afterwards just pull the results.

API docs for this:
https://atlas.ripe.net/docs/api/v2/manual/measurements/measurement-tags.html

 NAME:
   atlas measurements list - lists all measurements

USAGE:
   atlas measurements list [command options] [arguments...]

DESCRIPTION:
   displays all measurements

OPTIONS:
   --country value, -c value  filter on country
   --asn value                filter on asn
   -A, --all                  all measurements even inactive ones
   --is-anchor                select anchor measurements
   -t value, --type value     filter on measurement type

[keltia]

OK, that is two things, first searching for a specific lset of tags and the tags calls. I'll open an issue for the latter and work first on the former :)

[keltia]

Searching on tags is now in v0.41, committed in 65abcea.

Enjoy!