공식 문서에 기재가 없기 때문에, 불확정한 부분이 많이 있습니다만, 조사한 내용을 기재합니다.

JSON API permalink

Infrastructure List에서 참조할 수 있는 데이터의 JSON.

[Datadog] -> [Infrastrucure] -> [Infrastructure List] -> [JSON API permalink]

curl에서 얻는 방법

$ apikey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
$ appkey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
$ curl -s -S "https://app.datadoghq.com/reports/v2/overview?api_key=${apikey}&application_key=${appkey}"

옵션

with_ ~ 옵션은 지정하지 않거나 값없이 false. (false를 지정해도 true가 된다)

예:

ON

with_app=true

with_app=XXX (임의의 문자열)

OFF

지정하지 않음

with_app= (값을 지정하지 않음)

옵션
내용


with_apps
App Runnings

with_sources
데이터 검색 소스 (agent,aws,etc...)

with_aliases
호스트 이름 후보

with_meta
agent에서 검색할 수 있는 메타데이터

with_mute_status
host가 mute되어 있는 경우의 mute 해제 시간(UNIX TIME). mute 상태가 아닌 경우는 null

with_tags
true 고정(?). 옵션 지정/미지정 시에도 결과가 변함없이(?).

metrics
메트릭 정보를 쿼리(aggregation:metric 형식)로 지정. 쉼표로 구분하여 복수 지정 가능. row_metrics, rows.metorics를 부여.

JSON 구조

첫 번째 계층

[
  "display_hostname_dropdown",
  "row_type",
  "rows",
  "window"
]

window 이외의 각 파라미터는 고정과 같습니다.


항목(key)
설정값
내용


display_hostname_dropdown
ー(?)
고정으로 true

row_type
ー(?)
고정으로 호스트

rows
ー
각 호스트 정보

창
w/d/h/h:m
출력 대상 창. 기본 3h:15m

행(AWS)

[
  "aws_id",
  "aws_name",
  "display_name",
  "has_metrics",
  "host_name",
  "id",
  "last_seen",
  "name",
  "tags_by_source",
  "up"
]

항목(key)
내용


aws_id
AWS의 고유 식별자(EC2 InstanceID, ELB DNSName, RDS Endpoint, etc...)

aws_name
AWS의 이름(EC2 tag Name, ELB LoadBalancerName, RDS dbinstanceidentifier, etc...)

display_name
Datadog의 표시 이름

has_metrics
지표를 보유하고 있습니까? 옵션 미지정의 경우 false 고정.

host_name
Datadog의 식별자

id
Datadog의 ID

last_seen
최종 갱신 일시(?). UNIX TIME.

이름
Datadog의 표시 이름. display_name과 동일한 값(?)

tags_by_source
Host Tags

up
Datadog에서 데이터를 수신할 수 있는지 {true/false}. 호스트 삭제 후 3시간은 데이터 보존.

Host Tags

Name:Value 또는 Value 형식.

AWS : Amazon Web Services

User : Users

with_meta

with_meta 옵션이 활성화된 경우 부여.

  "agent_checks",
  "agent_version",
  "cpuCores",
  "gohai",
  "host_id",
  "machine",
  "nixV",
  "platform",
  "processor",
  "pythonV",
  "timezones"

metrics

with_metrics 옵션이 활성화된 경우 부여.
Datapoint(UNIXTIME), Value 가 지정한 쿼리분, 배열로 돌려준다.

"avg:aws.ec2.cpuutilization,avg:system.load.5"예

      "metrics": [
        [
          1495761500,
          0.800000011920929
        ],
        [
          1495761860,
          0
        ]
      ],

row_metrics

metrics 옵션이 활성화된 경우 부여.

[
  "aggr",
  "columns",
  "expression",
  "meta",
  "name"
]

avg:aws.ec2.cpuutilization를 지정한 경우의 예

{
  "meta": {
    "description": "Average percentage of allocated EC2 compute units that are currently in use on the instance.",
    "short_name": "cpu utilization",
    "unit_id": 17,
    "metric_type": "gauge",
    "per_unit_id": null,
    "unit": [
      {
        "scale_factor": 1,
        "family": "percentage",
        "short_name": "%",
        "plural": "percent",
        "id": 17,
        "name": "percent"
      },
      null
    ],
    "orientation": 0,
    "interval": null,
    "org_id": -1,
    "integration": "amazon_ec2",
    "metric_key": 100
  },
  "expression": "avg:aws.ec2.cpuutilization{*} by {host}",
  "name": "aws.ec2.cpuutilization",
  "columns": [
    "timestamp",
    "last"
  ],
  "aggr": "avg"
}

참고 URL

How to export your infrastructure list and Agent versions – Datadog