Метрики
Страницата Metrics (странична лента > Metrics) ви дава по-дълбок аналитичен поглед върху вашето API потребление. Тя показва цялостното разпределение на резултатите (outcomes) и разбива трафика по API key, client IP или целеви домейн.
За обобщени карти в реално време и графики на времевата линия (Concurrency, Requests, Bytes, Response Time), използвайте страницата Dashboard Overview.
Филтри
Над страницата са разположени два контрола: селектор за API key и селектор за интервал.
Филтър за ключ
Използвайте падащото меню API Key, за да ограничите обхвата на страницата до конкретен ключ. Показват се само ключове в рамките на вашия обхват на достъп: лични ключове, организационни ключове, които администрирате, или ключове, споделени чрез екипи.
Селектор за интервал
Използвайте бутоните за интервал, за да контролирате времевия прозорец:
| Бутон | Прозорец |
|---|---|
| 1M | Последната 1 минута |
| 5M | Последните 5 минути |
| 30M | Последните 30 минути |
| 1H | Последният 1 час |
| 6H | Последните 6 часа |
| 1D | Последните 24 часа |
Както кръговата диаграма (donut), така и таблицата следват вашия избор.
Разпределение на резултатите
Кръгова диаграма (donut chart) в горната част показва разпределението на успешни и неуспешни заявки за избрания интервал. Посочете с мишката върху произволен сектор, за да видите точния брой заявки и процент. Използвайте я, за да забележите бързо дали внезапен спад в процента на успеваемост съвпада с конкретна категория резултат (outcome).
Типове резултати
Всяка API request се класифицира в точно един outcome. Само success се отчита към вашата таксувана квота.
| Outcome | Layer | Значение |
|---|---|---|
success |
n/a | Заявката достави валиден отговор. Без правила за validate, това означава HTTP 200. Ако сте изпратили правила за validate, всеки отговор, приет от вашите правила, се счита за успех, независимо от HTTP статуса. |
application_error |
target | Целта върна HTTP 200, но тялото на отговора съдържаше поле за грешка. |
application_fail |
target | Целта върна статус, различен от 2xx, който вашите правила за validate не приеха, или изобщо не върна отговор. |
client_error |
caller | Вашата заявка беше отхвърлена, преди да напусне FourA: невалидни параметри, неправилно форматирана стойност на proxy или URL, който сочи към частен или резервиран IP адрес (SSRF защита). |
rate_limit |
FourA | Заявката беше отхвърлена от вашия лимит за RPM или concurrency. Вижте Rate Limits. |
service_error |
FourA | Бекендът върна 5xx или отговори с тяло, което не можахме да анализираме. |
service_fail |
FourA | Мрежова грешка: изтичане на времето (timeout), отказана връзка, DNS грешка, прекъсната връзка от клиента. |
Колоната layer ви казва кой е отговорен: target означава сайтът, който сте повикали, caller означава, че вашата заявка е била невалидна, FourA означава, че не сме успели да я обработим.
Ако използвате validate.status.accept, за да разрешите конкретни кодове, различни от 200 (например [200, 403]), тези отговори се връщат като success вместо application_fail. Класификацията следва решението на енджина спрямо вашите правила, а не суровия HTTP код.
За пълната таксономия и как тя се съпоставя с таксуването, вижте Request Outcomes.
Таблица за потребление с множество изгледи
Под кръговата диаграма таблица за потребление разбива вашия трафик с три раздела (tabs) за изглед:
| Раздел | Групира данните по |
|---|---|
| API Key | Всеки от вашите API keys |
| Client IP | Изходни IP адреси, правещи заявки |
| Domain | Целеви домейни във вашите заявки |
Всеки раздел поддържа четири бутона за обхват (scope chips) вдясно, които променят показваните колони:
| Обхват | Какво показва |
|---|---|
| Bandwidth | Брой заявки, входящи байтове, изходящи байтове |
| Response Time | Брой заявки, минимално, средно и максимално закъснение (latency) |
| Concurrency | Брой заявки плюс брой едновременни заявки (само за изглед API Key) |
| Outcomes | Брой заявки плюс разбивка по резултати (outcomes) |
Свързани теми
- Dashboard Overview: Статистика в реално време и графики на времевата линия
- Request Outcomes: Подробно обяснение на седемте стойности за резултат (outcome)
- API Errors: Как се връщат грешките по мрежата