Skip to main content

Відстеження активів

API asset tracker дозволяє відстежувати операції, яких зазнає актив під час проходження через трубопровід даних у Fledge, і відображати їх на екрані.

GET /fledge/track - повертає дані відстеження для одного чи кількох активів

Параметри

  • asset - визначає актив, який слід відстежувати. Якщо опущено, то дані відстеження для всіх активів повертаються
  • event - подія для відстеження. Якщо пропущено, буде повернуто всі події
  • service - обмежує дані відстеження певним сервісом

Response Payload

Масив відстежуваних подій, кожна з яких містить наступне

НазваТипОписПриклад
assetstringНазва активу, якого стосується ця подія відстеженняsinusoid
eventstringПодія, яка відстежувалася, буде однією з Ingest, Filter або EgressIngest
servicestringНазва сервісу, у якому відстежувалась ця подіяtestSignal4
fledgestringНазва екземпляра fledge, у якому відстежувалась ця подіяfledge002
pluginstringНазва плагіна, у якому відстежувалась ця подіяsinusoid
timestampstringПозначка часу, коли цю подію було вперше відстежено2022-07-06 10:20:13.059
deprecatedTimestampstringПозначка часу, коли цю подію було вилучено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 для видалення списання з події відстеження активу, це робиться автоматично, коли активи відстежуються в наступних подіях.