Аналитика облачного следа

Аналитика облачного следа принимает одну компанию и возвращает весь её облачный след: итоги, ведущие провайдеры, страны и регионы, число новых хостов по неделям, последние хосты и флаги — изменения, на которые стоит реагировать. Используйте поиск облачного следа, чтобы построить список компаний. Используйте аналитику, когда нужна полная картина по одной из них.

Перед началом

Вам нужен domain_search_id компании. Он есть в каждой записи поиска облачного следа, поиска компаний и просмотра компании.

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domains": ["platform9.com"], "per_page": 1 }'

Возьмите domain_search_id из первой записи.

Запрос

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }'

Ключ	Обязателен	Значение
`domain_search_id`	Да	Компания.
`date_from`	Нет	Начало диапазона дат, `YYYY-MM-DD`.
`date_to`	Нет	Конец диапазона дат, `YYYY-MM-DD`.

Без дат диапазон — последние 90 дней. Ваш тариф может ограничивать, насколько далеко в прошлое может уходить date_from.

Что возвращается

Ключ	Что это	Зависит от диапазона дат?
`totals`	Хосты, серверы, провайдеры, страны, зарубежные страны и регионы	Только `new_hosts`
`providers`	Топ-8 провайдеров	Нет
`countries`	Топ-8 стран, у каждой `evidence_url`	Нет
`regions`	Топ-8 облачных регионов	Нет
`weekly_series`	Хосты, впервые обнаруженные за каждую неделю	Да
`recent_hosts`	До 12 новейших хостов, одна запись на хост	Да
`window_days`	Число дней в диапазоне, включая обе границы	—
`flags`	Изменения, на которые стоит реагировать	Да

Хост — именованный адрес, который использует компания, например api.example.com. Сервер — уникальный IP-адрес за этими хостами. Топ-списки отсортированы по серверам, затем по хостам. Недели в weekly_series начинаются с понедельника в часовом поясе вашей рабочей области.

Флаги

Флаги превращают облачный след в то, с чем можно работать. Списков пять. В каждом до 8 элементов, новые первыми, и каждый элемент называет реальные хосты, которые вы можете проверить сами.

Флаг	Что означает	Почему это важно
`moved_hosts`	Хост теперь отвечает у другого провайдера, в другой стране или регионе.	Компания мигрирует или переезжает.
`twin_hosts`	Один и тот же сервис работает сразу в двух облаках, и одно из них добавлено недавно.	Мультиоблачное развёртывание или миграция в процессе.
`test_hosts`	Новый хост разработки, тестирования, staging или proof of concept в облаке, которое не является основным для компании.	Компания пробует новое облако. Это самый ранний сигнал.
`new_providers`	Провайдер, которого компания раньше не использовала.	Новые отношения с поставщиком.
`new_regions`	Новый регион или новая страна у провайдера, которого компания уже использовала.	Выход в новую географию.

Каждый флаг проверяется заново при каждом запросе. Изменение, которое уже отменено, из списка выпадает.

Перемещённые хосты

{
  "host": "onemindservices-new-jersey-prod.app.pcd.platform9.com",
  "is_provider_change": true,
  "from": { "provider": "AWS", "country_code": "US", "cloud_region": "us-west-2", "city": "Portland", "region_name": "Oregon", "first_seen_at": "2026-07-22T12:07:12.918787", "last_seen_at": "2026-07-22T12:19:41.499986" },
  "to": { "provider": "OCI", "country_code": "US", "cloud_region": "us-phoenix-1", "city": "Phoenix", "region_name": "Phoenix", "first_seen_at": "2026-09-13T16:07:26.248556", "last_seen_at": "2026-09-14T09:41:19.500363" },
  "is_live_confirmed": true
}

Этот продакшн-хост ушёл из AWS в Орегоне и теперь работает в Oracle Cloud в Финиксе.

is_provider_change равен true, если сменился провайдер, и false, если сменилась только страна или регион.
is_live_confirmed равен true, если хост прямо сейчас отвечает из to, и false, если хост ушёл из from, но его новое место подтвердить не удалось.

Хосты-двойники

{
  "service": "du.testbed.only.app.pcd",
  "providers": ["AWS", "OCI"],
  "new_provider": "AWS",
  "first_seen_at": "2026-07-21T11:59:25.286744",
  "new_provider_first_seen_at": "2026-09-10T09:23:35.767165",
  "hosts": [
    { "host": "test-du-testbed-only-5113915.app.qa-pcd.platform9.com", "provider": "AWS", "country_code": "US", "cloud_region": "us-west-2", "city": "Portland", "region_name": "Oregon", "first_seen_at": "2026-09-10T09:23:35.767165" },
    { "host": "test-du-testbed-only-5114083.app.qa-pcd.platform9.com", "provider": "OCI", "country_code": "US", "cloud_region": "us-phoenix-1", "city": "Phoenix", "region_name": "Phoenix", "first_seen_at": "2026-09-10T11:53:10.757998" }
  ]
}

service — имя, общее для хостов.
providers перечисляет облака, в которых работает сервис, новые первыми. new_provider — самое новое из них.
hosts даёт по одному работающему хосту на облако, до 3.

Тестовые хосты

{
  "host": "iam-dev.platform.ea.com",
  "tags": ["dev"],
  "is_poc": false,
  "primary_provider": "AWS",
  "first_seen_at": "2026-09-06T08:13:54.048967",
  "places": [
    { "provider": "GCP", "country_code": "US", "cloud_region": "us-central1", "city": "Council Bluffs", "region_name": "Iowa" }
  ]
}

Компания на AWS с новым хостом разработки в Google Cloud.

tags — слова в имени хоста, которые указывают, что это не продакшн.
is_poc равен true, если имя помечает proof of concept или пилот. Такие элементы идут первыми.
places — где хост работает сейчас. primary_provider сюда никогда не входит.

Новые провайдеры

{
  "provider": "Equinix Metal",
  "first_seen_at": "2026-09-14T02:08:27.707494",
  "host_count": 1,
  "hosts": [
    { "host": "hnjobs.cncf.io", "provider": "Equinix Metal", "country_code": "US", "cloud_region": null, "city": "Parsippany", "region_name": null, "first_seen_at": "2026-09-14T02:08:27.707494" }
  ]
}

host_count — сколько хостов у компании у этого провайдера сейчас.
hosts даёт до 3 работающих хостов как подтверждение.

Новые регионы

{
  "provider": "AWS",
  "country_code": "US",
  "cloud_region": "us-west-1",
  "city": "San Jose",
  "region_name": "N. California",
  "first_seen_at": "2026-09-09T22:44:04.868704",
  "host_count": 1,
  "hosts": [
    { "host": "mx.experience.zoom.us", "provider": "AWS", "country_code": "US", "cloud_region": "us-west-1", "city": "San Jose", "region_name": "N. California", "first_seen_at": "2026-09-09T22:44:04.868704" }
  ]
}

Провайдер использовался ещё до начала диапазона. Новый только регион. Если cloud_region равен null, флаг означает новую страну у этого провайдера.

Когда флаги пусты

flags равен null. Флаги для этой компании ещё не готовы. Остальной ответ всё равно полный.
Один список равен null. Этот список не удалось построить в этом вызове. Остальные списки действительны. Повторите запрос позже.
is_spam_flood равен true. Имена хостов компании слишком зашумлены для флагов, поэтому все списки пусты.
Список равен []. В диапазоне ничего не найдено. twin_hosts, test_hosts, new_providers и new_regions считают что-то новым, только когда Pubrio отслеживает компанию 90 дней, поэтому для недавно отслеживаемой компании списки пусты.

Рецепты

Кто уходит из облака
Изменения за заданный период
Посчитать все флаги

cURL

curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }' \
| jq '.data.flags.moved_hosts[] | select(.is_provider_change) | {host, from: .from.provider, to: .to.provider}'

Оставляет только переезды между провайдерами. Много переездов от одного провайдера указывают на миграцию.

cURL

curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418",
    "date_from": "2026-08-01",
    "date_to": "2026-08-31"
  }'

new_hosts, weekly_series, recent_hosts и все флаги теперь охватывают только август. Итоги и топ-списки не меняются.

cURL

curl -s -X POST https://api.pubrio.com/companies/cloud_footprints/insights \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain_search_id": "a8064391-03c6-4ed2-91b0-217a9f89d418" }' \
| jq '.data.flags | if . == null then "not ready" else with_entries(select(.value | type == "array") | .value |= length) end'

Быстрая проверка, в каких флагах что-то есть, прежде чем читать подробности.

Что стоит знать

Компания, работающая в двух странах, учитывается в записях обеих стран, поэтому сумма топ-списков может превышать totals.
is_cross_border равен null, если штаб-квартира компании неизвестна. Это «неизвестно», а не «внутренний рынок».

Связанное

Справочник аналитики облачного следа

Все ключи запроса и поля ответа.

Поиск облачного следа

Постройте список компаний по провайдеру, стране, региону и масштабу.

Настройка webhooks

Отправлять изменения облачного следа в webhook или почту.

Мониторинг

Поиск

Фильтры

Люди

Экспансия

Аналитика облачного следа

Перед началом

Запрос

Что возвращается

Флаги

Перемещённые хосты

Хосты-двойники

Тестовые хосты

Новые провайдеры

Новые регионы

Когда флаги пусты

Рецепты

Что стоит знать

Связанное

Справочник аналитики облачного следа

Поиск облачного следа

Настройка webhooks

​Перед началом

​Запрос

​Что возвращается

​Флаги

​Перемещённые хосты

​Хосты-двойники

​Тестовые хосты

​Новые провайдеры

​Новые регионы

​Когда флаги пусты

​Рецепты

​Что стоит знать

​Связанное

Справочник аналитики облачного следа

Поиск облачного следа

Настройка webhooks

Перед началом

Запрос

Что возвращается

Флаги

Перемещённые хосты

Хосты-двойники

Тестовые хосты

Новые провайдеры

Новые регионы

Когда флаги пусты

Рецепты

Что стоит знать

Связанное