Формат файла метрик
Для передачи данных о производительности вашей инфраструктуры в Cloudmaster необходимо реализовать механизм сбора метрик (коллектор). Ваша реализация должна обеспечивать выполнение трех ключевых задач: автоматический опрос API или баз данных первоисточника, преобразование полученных сведений в CSV-файлы строго в соответствии со спецификацией Cloudmaster и их последующую загрузку в целевые директории подключенного S3-бакета для регулярного импорта системой.
Технические требования к CSV⚓︎
- Порядок полей: Первые 6 полей должны следовать строго в указанном порядке.
- Заголовки: В первой строке файла должны быть указаны технические наименования полей.
- Разделитель: Запятая (
,), десятичный разделитель: точка (.). - Часовой пояс: Все временные метки передаются в UTC.
Требования к пути и именованию файлов⚓︎
Для того чтобы система Cloudmaster могла автоматически идентифицировать и сопоставлять данные с конкретным подключением, файлы должны размещаться в строго определенной структуре каталогов и иметь унифицированный формат имени.
Шаблон пути в бакете:
/{customerId}/load/cm-connection-{cloudId}/load-{customerId}-{cloudId}-{date:yyyyMMdd}.csv
Пример корректного пути к файлу:
/503c2d6b-bb2c-4f22-87b1-ee739csdrtс6/load/cm-connection-3478/load-503c2d6b-bb2c-4f22-87b1-ee739csdrtс6-3478-20260413.csv
Описание параметров шаблона
| Параметр | Описание | Где найти / Пример |
|---|---|---|
{customerId} |
Уникальный ID клиента в Cloudmaster. | В Профиле пользователя. |
load |
Директория, определяющая тип данных. | Метрики. |
{cloudId} |
Технический ID конкретного подключения. | В разделе Мои подключения на карточке созданного подключения. |
{date:yyyyMMdd} |
Дата, за которую предоставлены данные. | 20260413 (для данных за 13 апреля). |
.csv |
Расширение файла. | Рекомендуется нижний регистр. |
Структура данных (Схема полей)⚓︎
Все поля являются обязательными.
| № | Поле | Тип | Описание | Пример |
|---|---|---|---|---|
| 1 | UsageAt | DateTime | Время замера в формате ISO 8601: YYYY-MM-DDThh:mm:ssZ. |
2026-04-14T00:00:00Z |
| 2 | ObjectId | String | Внешний ID ресурса (должен совпадать с ID в файле биллинга). | i-07f123456789 |
| 3 | ResourceCode | String | Тип ресурса из справочника Cloudmaster (например: cpu, ram, network_in, network_out). |
cpu |
| 4 | ResourceSKU | String | Артикул ресурса, к которому относится метрика. | sku-776-std |
| 5 | MaxQuantity | Double | Максимальное потребленное значение в абсолютных единицах за час. | 4.0 |
| 6 | MaxPercent | Double | Максимальный процент утилизации за час (0.0 — 100.0). | 85.5 |
Описание ключевых метрик⚓︎
Cloudmaster использует для расчета рекомендаций по оптимизации следующие коды метрик:
-
cpu: Нагрузка на процессор (в процентах). -
ram: Использование оперативной памяти. -
network_in: Входящий сетевой трафик. -
network_out: Исходящий сетевой трафик.
Изменять перечень стандартных кодов можно через справочники.
Важно для сопоставления: Значение в поле
ObjectIdв файле метрик должно быть идентично значениюObjectIdв файле биллинга. Только в этом случае система сможет сопоставить затраты на объект с реальной нагрузкой на его ресурсы.
Требования к группировке и полноте⚓︎
- Гранулярность: Данные в файле должны быть агрегированы по часам.
- Ожидаемые данные: В момент опроса в бакете должен присутствовать файл, содержащий данные за предыдущие полные сутки (00:00:00 — 23:59:59 UTC).