INTEGRITY Документация

← Аналитика / analytics / graphql-api / migration-guides

Network Analytics v1 на Network Analytics v2

В начале 2020 года Cloudflare выпустила первую версию дашборда Network Analytics и соответствующего API. Вторая версия (Network Analytics v2) стала доступна 2021-09-13.

Прежде чем начать

Подробнее о концепции, появившиеся в Network Analytics v2.

Сравнение функций

В следующей таблице сравниваются возможности NAv1 и NAv2:

Возможность NAv1 NAv2
Частота дискретизации 1/8,192 пакетов Варьируется от 1/100 до 1/1,000,000 пакетов,
в зависимости от службы защиты от атак.
Метод выборки Core Sample Enrichment Edge Sample Enrichment
Метод хранения исторических данных Агрегированные сводные отчёты Adaptive Bit Rate
Срок хранения Сводки за 1 минуту: 30 дней
Сводки за 1 час: 6 месяцев
Сводки за 1 день: 1 год
Сводные отчёты об атаках: 1 год		 Все узлы: 16 недель
Системы защиты от атак dosd dosd, flowtrackd*, и Cloudflare Network Firewall*
Примеры новых полей н/д ID правила
ID туннеля GRE
Размер пакета

* Применимо только для клиентов Magic Transit.

Подробности о различиях в методе выборки и хранении исторических данных см. в Основные различия между Network Analytics v1 и v2.

Сравнение узлов

NAv2 использует ту же конечную точку API, но задействует новые узлы. NAv1 включает три узла для агрегированных сводок по всему трафику и атакам и один узел для атак, тогда как в NAv2 есть один узел для всего трафика и атак и четыре отдельных узла для атак, различающихся по системе защиты.

Тип узла NAv1 NAv2 для Magic Transit NAv2 для Spectrum
Главный узел (узлы) ipFlows1mGroups
ipFlows1hGroups
ipFlows1dGroups		 magicTransitNetworkAnalyticsAdaptiveGroups spectrumNetworkAnalyticsAdaptiveGroups
Узел(ы) атаки ipFlows1mAttacksGroups dosdNetworkAnalyticsAdaptiveGroups
dosdAttackAnalyticsGroups
flowtrackdNetworkAnalyticsAdaptiveGroups
magicFirewallNetworkAnalyticsAdaptiveGroups		 dosdNetworkAnalyticsAdaptiveGroups
dosdAttackAnalyticsGroups

Каждая строка представляет собой один образец пакета. Данные выбираются на периферийной сети Cloudflare с частотой различной. Частоту выборки узлов также можно запросить с помощью sample_interval поле.

Справочную информацию об узлах NAv2 см. в Справочник по узлам NAv2.

Сравнение схем

См. Сопоставление схемы NAv1 и NAv2 , где приведено сопоставление полей схемы узлов NAv1 и узлов NAv2. При миграции на NAv2 следуйте этому рекомендованному сопоставлению.

Пример

Следующий пример запрашивает 20 записей о трафике, отклонённом системами защиты, отличными от Cloudflare Network Firewall, за заданный период, отсортированных по IP-адресу назначения.

{
	viewer {
		accounts(filter: { accountTag: "<REDACTED>" }) {
			magicTransitNetworkAnalyticsAdaptiveGroups(
				filter: {
					datetime_gt: "2021-10-01T00:00:00Z"
					datetime_lt: "2021-10-05T00:00:00Z"
					outcome_like: "drop"
					mitigationSystem_neq: "magic-firewall"
				}
				limit: 20
				orderBy: [ipDestinationAddress_ASC]
			) {
				dimensions {
					outcome
					mitigationSystem
					ipSourceAddress
					ipDestinationAddress
					ipProtocol
					destinationPort
				}
			}
		}
	}
}

Заключительные замечания

mitigationSystem поле может принимать одно из следующих значений: