Налаштування KrakenD API Gateway під ключ

N+1 запитів та фрагментовані API: типова архітектурна біль

Ваше SPA робить 30 запитів на сторінку, N+1 query в GraphQL не вирішив проблему фрагментації API. Кожен мікросервіс віддає свої дані, клієнтський код обростає ланцюжками викликів. Ми — команда інженерів з 5-річним досвідом впровадження KrakenD. Наша спеціалізація — високонавантажені API Gateway, що обробляють до 70 000 RPS на одному ядрі. KrakenD — stateless API Gateway на Go з декларативною конфігурацією в одному JSON/YAML файлі. Його фішка — агрегація відповідей кількох backend-сервісів в одну відповідь клієнту (API composition). Це знижує затримки та спрощує клієнтський код.

Як KrakenD вирішує проблему агрегації API?

KrakenD об'єднує паралельні запити до бекендів в одну відповідь. Клієнт бачить лише один endpoint, а шлюз сам збирає дані. Це позбавляє необхідності писати BFF або використовувати костилі на кшталт server-side includes.

Чому KrakenD швидше за Kong?

У бенчмарках KrakenD показує до 70K RPS на ядро — в 2–3 рази вище, ніж Kong (25K RPS). Причина — мінімалістична кодова база на Go та відсутність плагінів, які гальмують обробку. Для high-load проєктів це критично: ви економите на залізі та зберігаєте низьку затримку. За даними офіційних бенчмарків KrakenD Benchmarks, різниця особливо помітна при агрегації кількох бекендів.

Агрегація в ділі

Типовий endpoint /api/v1/user-profile звертається до трьох сервісів: users, billing, prefs. KrakenD запускає їх паралельно та повертає об'єднаний JSON. У конфігу це виглядає так:

{
  "$schema": "https://www.krakend.io/schema/v3.json",
  "version": 3,
  "name": "MyApp API Gateway",
  "timeout": "3000ms",
  "cache_ttl": "300s",
  "output_encoding": "json",
  "port": 8080,
  "endpoints": [
    {
      "endpoint": "/api/v1/user-profile",
      "method": "GET",
      "output_encoding": "json",
      "backend": [
        {
          "url_pattern": "/users/{JWT_CLAIMS.user_id}",
          "host": ["http://users-service:3000"],
          "mapping": {
            "data": "user"
          }
        },
        {
          "url_pattern": "/subscriptions/active?user_id={JWT_CLAIMS.user_id}",
          "host": ["http://billing-service:3001"],
          "mapping": {
            "plan": "subscription_plan"
          }
        },
        {
          "url_pattern": "/preferences/{JWT_CLAIMS.user_id}",
          "host": ["http://prefs-service:3002"],
          "mapping": {
            "settings": "preferences"
          }
        }
      ],
      "extra_config": {
        "auth/validator": {
          "alg": "RS256",
          "jwk_url": "http://auth-service:4000/.well-known/jwks.json",
          "cache": true,
          "cache_duration": 300
        }
      }
    }
  ]
}

Клієнт робить один GET-запит і отримує {"user":{"id":"123","name":"Alice"},"subscription_plan":"pro","preferences":{"theme":"dark"}}. Без KrakenD довелося б робити 3 запити та об'єднувати на клієнті — зростання складності та часу завантаження.

Rate Limiting та Circuit Breaker

Для захисту бекендів від перевантажень ми налаштовуємо rate limiting (по IP або токену) та circuit breaker. Приклад конфігурації:

{
  "endpoint": "/api/v1/search",
  "backend": [
    {
      "url_pattern": "/search",
      "host": [
        "http://search:3000"
      ]
    }
  ],
  "extra_config": {
    "qos/ratelimit/router": {
      "max_rate": 100,
      "client_max_rate": 10,
      "strategy": "ip",
      "capacity": 100,
      "client_capacity": 10
    },
    "qos/circuit-breaker": {
      "interval": 60,
      "timeout": 10,
      "max_errors": 5,
      "name": "search-cb",
      "log_status_change": true
    }
  }
}

Circuit breaker відключає проблемний бекенд на 10 секунд після 5 помилок, запобігаючи каскадним збоям. Помилки валідації JWT також відсікаються на рівні шлюзу, знижуючи навантаження на сервіси.

Кешування та додаткові трансформації

KrakenD підтримує кешування відповідей (cache_ttl) та трансформацію за допомогою Lua-скриптів або вбудованих фільтрів. Це дозволяє, наприклад, фільтрувати чутливі поля перед відправкою клієнту. Для частих запитів кеш може знизити затримку до 80%.

Процес налаштування KrakenD

Ми працюємо за чітким планом, щоб ви отримали стабільний шлюз без сюрпризів.

Аналіз та проектування архітектури

Вивчаємо вашу архітектуру: список сервісів, ендпоінти, вимоги до аутентифікації та безпеки. Складаємо схему агрегації та вибираємо стратегію кешування.

Встановлення та конфігурація

Встановлення через Docker:

docker run -p 8080:8080 \
    -v $PWD/krakend.json:/etc/krakend/krakend.json \
    devopsfaith/krakend:2.7 run -c /etc/krakend/krakend.json

Ми створюємо конфігурацію з вашими ендпоінтами, JWT-валідацією, rate limiting та circuit breaker. Використовуємо KrakenD Designer для візуальної перевірки.

Інтеграція моніторингу

Налаштовуємо метрики Prometheus та дашборди Grafana. Приклад секції моніторингу:

{
  "extra_config": {
    "telemetry/metrics": {
      "collection_time": "60s",
      "proxy_disabled": false,
      "router_disabled": false,
      "backend_disabled": false,
      "endpoint_disabled": false,
      "listen_address": ":9091"
    },
    "telemetry/opentelemetry": {
      "service_name": "krakend-gateway",
      "exporters": {
        "prometheus": [
          {
            "port": 9090,
            "disable_metrics": false
          }
        ],
        "otlp": [
          {
            "name": "jaeger",
            "host": "jaeger",
            "port": 4317,
            "use_http": false
          }
        ]
      }
    }
  }
}

Ви отримуєте дашборди з LCP, TTFB, кількістю помилок та завантаженням бекендів.

Тестування та деплой

Проводимо навантажувальне тестування, перевіряємо агрегацію, timeout, circuit breaker. Після успішного тесту деплоїмо у ваше середовище (Kubernetes, bare metal, хмара).

Документація та навчання

Передаємо повну документацію: схему конфігурації, інструкцію з додавання ендпоінтів, адреси дашбордів. Проводимо семінар для вашої команди.

Що входить у налаштування?

Чому обирають нас?

Ми — сертифіковані інженери з 5-річним досвідом роботи з KrakenD. Запустили 50+ проєктів, включаючи high-load системи з трафіком 100K RPS. Гарантуємо uptime 99.9% та передаємо проєкт з повною документацією. Завдяки агрегації та кешуванню наші клієнти економлять до 40% витрат на інфраструктуру. Окупність налаштування — зазвичай 3–4 місяці.

Замовте налаштування KrakenD під ключ — від консультації до моніторингу. Оцінимо ваш проєкт за 1 день. Отримайте готовий шлюз з документацією та навчанням команди. Зв'яжіться з нами для початку.

Строки орієнтовно

Базове налаштування з агрегацією, JWT та rate limiting — 2–3 робочих дні. Складна конфігурація з трансформаціями та observability — 4–5 днів. Вартість розраховується індивідуально після аналізу вашої архітектури.