Extend documentation with idea / plugin log severity configuration guide

[hsz]

See #708

[YannCebron]

https://plugins.jetbrains.com/docs/intellij/ide-infrastructure.html - obsolete?

[ZSmallX]

https://plugins.jetbrains.com/docs/intellij/ide-infrastructure.html - obsolete?

@YannCebron @hsz I think it' better to add log severity configuration guide for plugin developers from both https://plugins.jetbrains.com/docs/intellij/ide-infrastructure.html and https://www.jetbrains.com/help/idea/2021.3/setting-log-options.html

It did take some time for plugin developers to know how to attach idea.log from sandbox build/idea-sandbox/system/log/idea.log to console in Gradle runIde running configurations. At least, I did take much time to do this, by searching all the related issues, docs and guides from everywhere.

References:
https://github.com/JetBrains/gradle-intellij-plugin/issues/43 https://github.com/JetBrains/gradle-intellij-plugin/issues/152

[cschar]

https://plugins.jetbrains.com/docs/intellij/ide-infrastructure.html - obsolete?

By default, all messages with level INFO and higher are written to log output file idea.log. To enable DEBUG/TRACE logging for specific categories, use Help | Diagnostic Tools | Debug Log Settings.

Is there some way to set this from the plugin using the build.gradle.kts file instead of typing it in manually inside the launched sandbox IDE? https://imgur.com/a/aXFpKfE

I have tried

    runIde {
        systemProperties["idea.log.debug.categories"] = "#com.cschar.myplugin"
        systemProperties["idea.log.trace.categories"] = "#com.cschar.myplugin"
    }

but when I open the sandbox Help | Diagnostic Tools | Debug Log Settings. it shows an empty text box.. I think I am misconfiguring in runIde ?

[YannCebron]

The values shown in Help | Diagnostic Tools | Debug Log Settings have nothing to do with those defined in Gradle build script. Please try linked sample snipped for runIde https://plugins.jetbrains.com/docs/intellij/testing-faq.html#how-to-enable-debugtrace-logging

[cschar]

The values shown in Help | Diagnostic Tools | Debug Log Settings have nothing to do with those defined in Gradle build script

Ok thank you for clarifying... As an aside, is there a way to populate the contents of Help | Diagnostic Tools | Debug Log Settings inside the sandbox-ide from the gradle build script? or another method? Basically when launching the sandbox-ide after a gradle clean, the contents are empty and I have to re-add some namespaces by manually entering some values. It would be nice if there was a way to set it programmatically