- Configure appropriate JVM heap settings
- Monitor index sizes and optimize mappings
- Use streaming for large data imports

### Debug Logging

Enable debug logging for detailed troubleshooting:

```java
// Add to your logging configuration
logger.debug.org.codelibs.fess.suggest=DEBUG
```

## Contributing

1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-feature`

            try {
                if (this.treeConnection != null) {
                    // Release the tree connection if possible
                    log.debug("Releasing tree connection during emergency cleanup");
                }
            } catch (Exception e) {
                log.debug("Error releasing tree connection during emergency cleanup", e);
            }

            // Note: resourceLoc is final, cannot be set to null

        try {
            if (channel.getTransport() != null) {
                channel.getTransport().close();
            }
        } catch (Exception e) {
            log.debug("Error disconnecting removed channel", e);
        }
    }

    /**
     * Establish a replacement channel
     */
    public void establishReplacementChannel() {
        if (!multiChannelEnabled)

        loadProtocols("org.codelibs.fess.net.protocol");

        if (logger.isDebugEnabled()) {
            logger.debug("Web protocols: protocols={}", Arrays.toString(webProtocols));
            logger.debug("File protocols: protocols={}", Arrays.toString(fileProtocols));
        }
    }

    /**
     * Loads protocol handlers from the specified base package by scanning for

     permission java.lang.RuntimePermission "accessDeclaredMembers";
     permission java.util.PropertyPermission "intellij.debug.agent", "read";
     permission java.util.PropertyPermission "intellij.debug.agent", "write";
     permission org.bouncycastle.crypto.CryptoServicesPermission "exportSecretKey";
     permission org.bouncycastle.crypto.CryptoServicesPermission "exportPrivateKey";

                logger.debug("Interrupt {}", runningThread);
            }
            runningThread.interrupt();
            ThreadUtil.sleepQuietly(1000L);
            count++;
        }
    }

    /**
     * Stops the timeout target by setting the running flag to false.
     */
    public void stop() {
        if (logger.isDebugEnabled()) {
            logger.debug("Timeout target has been stopped.");

        logger.debug("Populating class realm {}", classRealm.getId());

        for (ClassRealmConstituent constituent : constituents) {
            File file = constituent.getFile();

            if (logger.isDebugEnabled()) {
                String id = getId(constituent);
                logger.debug("  Included: {}", id);
            }

            try {

        final long startTime = System.currentTimeMillis();
        final String contextPath = resolveContextPath();
        if (logger.isDebugEnabled()) {
            logger.debug("[RAG] Starting chat request. sessionId={}, userId={}, userMessage={}", sessionId, userId, userMessage);
        }

        final ChatSession session = chatSessionManager.getOrCreateSession(sessionId, userId);

        this.projectId = ProjectBuildLogAppender.getProjectId();
    }

    @Override
    public void debug(String message) {
        setMdc();
        logger.debug(message);
    }

    @Override
    public void debug(String message, Throwable throwable) {
        setMdc();
        logger.debug(message, throwable);
    }

    @Override
    public boolean isDebugEnabled() {

        validate(form, messages -> {}, this::asListHtml);
        verifyToken(this::asListHtml);
        final String fileName = form.bulkFile.getFileName();

        if (logger.isDebugEnabled()) {
            logger.debug("Backup file upload initiated: fileName={}", fileName);
        }

        final File tempFile = ComponentUtil.getSystemHelper().createTempFile("fess_restore_", ".tmp");