Skip to content

Expand Troubleshooting Documentation page #511

@pratik-mahalle

Description

@pratik-mahalle

Describe the bug

The current troubleshooting section only contains guidance on changing log levels. Given the complexity of Microcks features (dispatchers, async protocols, Keycloak integration, etc.), users would benefit from expanded troubleshooting content.

Proposed Solution
Expand the troubleshooting (_index.md) page with additional sections covering common issues and their solutions.

Attach any resources that can help us understand the issue.

You can Expand the existing page with additional sections covering common issues:

  • Import Issues - artifact validation errors, encoding problems, "no service found"
  • Mock Not Responding - 404 errors, wrong responses, dispatcher debugging
  • Authentication/Keycloak Issues - 401 errors, token problems, CORS
  • Async API / Kafka Issues - broker connectivity, Schema Registry, SSL config
  • Performance Issues - slow responses, memory usage, startup time
  • Each section will use collapsible
    Details elements (already used in the file) for clean organization.

Breaking change? No - this is purely additive documentation content.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions