Skip to content

Commit

Permalink
docs(kic): add konnect integration troubleshooting section (#7853)
Browse files Browse the repository at this point in the history
* docs(kic): add konnect integration troubleshooting section

* Apply suggestions from code review

Co-authored-by: lena-larionova <[email protected]>

---------

Co-authored-by: lena-larionova <[email protected]>
  • Loading branch information
czeslavo and lena-larionova authored Sep 26, 2024
1 parent cfd433d commit 7601490
Showing 1 changed file with 19 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -359,3 +359,22 @@ kong admin` for configuration push failures.
{{ site.kic_product_name }} provides Kubernetes Events to help understand the state of your system. Events occur when an invalid configuration is rejected by {{ site.base_gateway }} (`KongConfigurationApplyFailed`) or when an invalid configuration such as an upstream service that does not exist is detected (`KongConfigurationTranslationFailed`)..
For more information, see [Events](/kubernetes-ingress-controller/{{ page.release }}/production/observability/events/).
{% if_version gte:3.3.x %}
### Debugging {{ site.konnect_short_name }} integration
{{ site.kic_product_name }} needs to communicate with the {{ site.konnect_short_name }} cloud APIs to provide the [integration](/konnect/gateway-manager/kic).
If you encounter issues with KIC in {{ site.konnect_short_name }}, you should first inspect logs from {{ site.kic_product_name }} to identify the root cause.
By default, KIC logs the details for every failed request and response (method, URL, status code) it
receives from {{ site.konnect_short_name }}. If you set the `LOG_LEVEL` to `trace`, {{ site.kic_product_name }} will log the details for _every_ request and response it receives from {{ site.konnect_short_name }}.
Here is an example of a failed request/response log entry:
```text
Request failed {"x_b3_traceid": "66c731200000000034ce3297e8e64544", "x_b3_spanid": "4e6955874299011d", "x_datadog_trace_id": "3805034363203503428", "x_datadog_parent_id": "5650141246939267357", "v": 0, "method": "GET", "url": "https://us.kic.api.konghq.tech/kic/api/control-planes/81bc4af5-ed3c-40b4-bb88-b5a05fbe34a1/oauth2?size=1000", "status_code": 404}
```
If your issue requires further investigation on the {{ site.konnect_short_name }} side, attach logs with tracing information to your support ticket.
{% endif_version %}

0 comments on commit 7601490

Please sign in to comment.