Відстеження активів
API asset tracker дозволяє відстежувати операції, яких зазнає актив під час проходження через трубопровід даних у Fledge, і відображати їх на екрані.
GET /fledge/track - повертає дані відстеження для одного чи кількох
активів
Параметри
asset- визначає актив, який слід відстежувати. Якщо опущено, то дані відстеження для всіх активів повертаютьсяevent- подія для відстеження. Якщо пропущено, буде повернуто всі подіїservice- обмежує дані відстеження певним сервісом
Response Payload
Масив відстежуваних подій, кожна з яких містить наступне
| Назва | Тип | Опис | Приклад |
|---|---|---|---|
| asset | string | Назва активу, якого стосується ця подія відстеження | sinusoid |
| event | string | Подія, яка відстежувалася, буде однією з Ingest, Filter або Egress | Ingest |
| service | string | Назва сервісу, у якому відстежувалась ця подія | testSignal4 |
| fledge | string | Назва екземпляра fledge, у якому відстежувалась ця подія | fledge002 |
| plugin | string | Назва плагіна, у якому відстежувалась ця подія | sinusoid |
| timestamp | string | Позначка часу, коли цю подію було вперше відстежено | 2022-07-06 10:20:13.059 |
| deprecatedTimestamp | string | Позначка часу, коли цю подію було вилучено | 2022-07-06 10:20:13.059 |
Примітка
Застарівання відстеження активів дозволяє приховати стару інформацію про плагін, який поглинув актив, коли цей актив більше не поглинається плагіном. Коли це робиться, значення deprecatedTimestamp встановлюється як непорожня мітка часу.
Example
Повертає дані відстеження активу для активу з назвою sinusoid.
curl http://localhost:8081/fledge/track?asset=sinusoid
Повертає
{
"track": [
{
"asset": "sinusoid",
"event": "Filter",
"service": "test1",
"fledge": "Fledge",
"plugin": "test2",
"timestamp": "2022-07-06 10:20:13.059"
},
{
"asset": "sinusoid",
"event": "Ingest",
"service": "test1",
"fledge": "Fledge",
"plugin": "sinusoid",
"timestamp": "2022-07-11 16:12:25.749"
},
{
"asset": "sinusoid",
"event": "Filter",
"service": "test1",
"fledge": "Fledge",
"plugin": "python35",
"timestamp": "2022-07-13 12:33:10.082"
},
{
"asset": "sinusoid",
"event": "Egress",
"service": "OMF",
"fledge": "Fledge",
"plugin": "OMF",
"timestamp": "2022-07-15 14:07:14.950"
}
]
}
Списання
Існують певні обставини, за яких старі дані щодо відстеження активів необхідно видалити. Зокрема, коли плагін поглинає кілька ресурсів або назви ресурсів змінилися, користувачеві зручно видалити зв'язок зі старими назвами ресурсів.
PUT /fledge/track/service/service_name/asset/asset_name/event/event_name -
позначити подію відстеження активу як списану
Параметри
service_name- назва сервісу, для якого ми хочемо списати подію відстеження активуasset_name- назва активу, який ми повинні списатиevent_name- назву події, яку потрібно списати
Примітка
Немає API для видалення списання з події відстеження активу, це робиться автоматично, коли активи відстежуються в наступних подіях.