Статистика

Інтерфейс statistics дозволяє отримувати поточну статистику, статистичну історію та статистичні показники для пристрою Fledge.

Fledge записує ряд статистичних значень, деякі з яких мають фіксовані назви, а інші відображають назву послуги або активу. Лічильники статистики з фіксованими назвами наведені нижче.

Ключ	Опис
BUFFERED	Зчитування наразі в буфері Fledge
DISCARDED	Зчитування відкидаються Південним сервісом перед розміщенням у буфері. Це може бути пов'язано з помилкою в самих зчитуваннях.
PURGED	Зчитування, видалені з буфера в процесі очищення
READINGS	Зчитування отримні Fledge
UNSENT	Зчитування відфільтровано в процесі надсилання
UNSNPURGED	Зчитування, які було видалено з буфера перед надсиланням

На додаток до цих фіксованих назв будуть і інші;

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

Одна статистика для кожного об'єкту з такою ж назвою, як і об'єкт. Це буде кількість зчитувань, які були прийняті для цього активу.

Одна статистика для південного сервісу, яка називається так само, як і сервіс, з додаванням Ingest. Це кількість зчитувань, прочитаних для цього сервісу.

GET statistics

GET /fledge/statistics - повертає загальний набір статистичних даних

Response Payload

Корисне навантаження відповіді – це документ JSON зі статистичною інформацією (всі числові), ці статистичні дані є абсолютними показниками з моменту запуску Fledge.

Example

$ curl -s http://localhost:8081/fledge/statistics
[ {
    "key": "BUFFERED",
    "description": "Readings currently in the Fledge buffer",
    "value": 0
  },
...
  {
    "key": "UNSNPURGED",
    "description": "Readings that were purged from the buffer before being sent",
    "value": 0
  },
... ]
.

## GET statistics/history

`GET /fledge/statistics/history` - повертає історичний набір
статистичних даних. Цей інтерфейс зазвичай використовується для
перевірки того, чи надсилає набір датчиків або пристроїв дані до Fledge,
шляхом порівняння нещодавньої статистики та кількості зчитувань,
отриманих для активу.

**Параметри запиту**

-   **limit** - обмежує набір результатів до *N* останніх записів.

**Response Payload**

JSON-документ, що містить масив статистичної інформації, ця статистика є
дельта-рахунками з моменту попереднього запису в масиві. Часовий
інтервал між значеннями є константою, яка визначає процес збору даних,
що заповнює статистику історії на рівні зберігання.

| Ключ                             | Опис                                                                                                                         |
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| interval                         | Інтервал у секундах між послідовними значеннями статистики                                                                   |
| statistics\[\].BUFFERED          | Зчитування наразі в буфері Fledge                                                                                            |
| statistics\[\].DISCARDED         | Зчитування відкидаються Південним сервісом перед розміщенням у буфері. Це може бути пов'язано з помилкою в самих показаннях. |
| statistics\[\].PURGED            | Зчитування, видалені з буфера в процесі очищення                                                                             |
| statistics\[\].READINGS          | Зчитування, отримані Fledge                                                                                                  |
| statistics\[\].*NORTH_TASK_NAME* | Кількість зчитувань, надісланих плагіном із назвою північного екземпляра до системи надходження                              |
| statistics\[\].UNSENT            | Зчитування, що відфільтровано в процесі надсилання                                                                           |
| statistics\[\].UNSNPURGED        | Зчитування, які було видалено з буфера перед надсиланням                                                                     |
| statistics\[\].*ASSET-CODE*      | Кількість зчитувань, отриманих Fledge з моменту запуску з назвою *asset-code*                                                |

**Example**

``` console
$ curl -s http://localhost:8081/fledge/statistics/history?limit=2
{
  "interval": 15,
  "statistics": [
    {
      "history_ts": "2020-06-01 11:21:04.357",
      "READINGS": 0,
      "BUFFERED": 0,
      "UNSENT": 0,
      "PURGED": 0,
      "UNSNPURGED": 0,
      "DISCARDED": 0,
      "Readings Sent": 0
    },
    {
      "history_ts": "2020-06-01 11:20:48.740",
      "READINGS": 0,
      "BUFFERED": 0,
      "UNSENT": 0,
      "PURGED": 0,
      "UNSNPURGED": 0,
      "DISCARDED": 0,
      "Readings Sent": 0
    }
  ]
}
.

## GET statistics/rate

`GET /fledge/statistics/rate` - повертає набір швидкостей для набору
статистичних даних. Цей інтерфейс повертає частоту значення статистики в
підрахунках за хвилину для вказаного набору середніх значень. Йому
передаються два параметри: список інтервалів у хвилинах, розділених
комами, і список статистичних даних, розділених комами.

**Параметри запиту**

> -   **statistics** -розділений комами список ключів статистики.
> -   **periods** - розділений комами список періодів часу в хвилинах.

Відповідна швидкість, яку буде повернено для заданого значення X, — це
кількість підрахунків за хвилину за попередні X хвилин.

**Example**

``` console
$ curl -sX GET http://localhost:8081/fledge/statistics/rate?statistics=READINGS,Readings%20Sent\&periods=1,5,15,30,60

 {
   "rates": {
     "READINGS": {
       "1": 2561.0,
       "5": 512.2,
       "15": 170.73333333333332,
       "30": 85.36666666666666,
       "60": 42.68333333333333
     },
     "Readings Sent": {
       "1": 2225.0,
       "5": 445.0,
       "15": 148.33333333333334,
       "30": 74.16666666666667,
       "60": 37.083333333333336
     }
   }
 }

GET statistics​

GET statistics