Added Access Log Configuration sample documentation for RESTEasy + Servlet

[masini]

Few lines to describe how-to

[rsvoboda]

Please fix the file name

[masini]

Hi Rostislav, which file must be renamed ?

[rsvoboda]

Category is not recognized parameter

Caused by: java.lang.RuntimeException: Failed to start quarkus
	at io.quarkus.runner.ApplicationImpl2.<clinit>(ApplicationImpl2.zig:131)
	... 16 more
Caused by: java.lang.RuntimeException: java.lang.IllegalArgumentException: UT000045: Error parsing predicated handler string unknown parameter category:
access-log(format='common', category='my.own.category')
                                                     ^
	at io.quarkus.undertow.runtime.UndertowDeploymentRecorder.bootServletContainer(UndertowDeploymentRecorder.java:405)
	at io.quarkus.deployment.steps.UndertowBuildStep$build37.deploy_0(UndertowBuildStep$build37.zig:444)
	at io.quarkus.deployment.steps.UndertowBuildStep$build37.deploy(UndertowBuildStep$build37.zig:36)
	at io.quarkus.runner.ApplicationImpl2.<clinit>(ApplicationImpl2.zig:117)
	... 16 more
Caused by: java.lang.IllegalArgumentException: UT000045: Error parsing predicated handler string unknown parameter category:
access-log(format='common', category='my.own.category')
                                                     ^
	at io.undertow.server.handlers.builder.PredicatedHandlersParser.error(PredicatedHandlersParser.java:729)
	at io.undertow.server.handlers.builder.PredicatedHandlersParser.handleHandlerNode(PredicatedHandlersParser.java:171)
	at io.undertow.server.handlers.builder.PredicatedHandlersParser.handleNode(PredicatedHandlersParser.java:114)
	at io.undertow.server.handlers.builder.PredicatedHandlersParser.parse(PredicatedHandlersParser.java:91)
	at io.undertow.server.handlers.builder.PredicatedHandlersParser.parse(PredicatedHandlersParser.java:80)
	at io.quarkus.undertow.runtime.UndertowHandlersConfServletExtension.handleDeployment(UndertowHandlersConfServletExtension.java:33)
	at io.undertow.servlet.core.DeploymentManagerImpl.handleExtensions(DeploymentManagerImpl.java:300)
	at io.undertow.servlet.core.DeploymentManagerImpl.deploy(DeploymentManagerImpl.java:155)
	at io.quarkus.undertow.runtime.UndertowDeploymentRecorder.bootServletContainer(UndertowDeploymentRecorder.java:394)
	... 19 more

[rsvoboda]

undertow-handler.conf
to
undertow-handlers.conf

[masini]

Ok for the filename, I forgot the final "s".

Regarding the configuration, I pasted there my current config, I also looked at the configuration builder and I read this:

@Override
public Map<String, Class<?>> parameters() {

    Map<String, Class<?>> params = new 
    params.put("format", String.class);
    params.put("category", String.class);
    return params;
}

I'm using 0.21.1, but I can see that master version is without category.

Should I document 0.21.1 or next version (the latter I think) ?

[rsvoboda]

Maybe missing category is a bug ...
@stuartwdouglas can you look at this ?

@masini docs in master should be relevant to master, but first I think we need to know more about missing category

[masini]

What about this PR ?

[machi1990]

@masini looks like there a conflicts, can you rebase on top of master? Thanks.

@rsvoboda do you mind having another look if the PR is okay for you? Thanks.

[rsvoboda]

• This needs rebase because of onflicting files
• Is category='my.own.category' working now ?
• I still see undertow-handler.conf (missing s for handlers)

[cescoffier]

Rebased required.

[gsmet]

I force-pushed a rebase and some adjustments.

I think the category issue was fixed in quarkus-http. @rsvoboda could you see if you can still reproduce the issue?

Also, I don't know if this works without Undertow. If someone had the time to check, that would be nice.

[rsvoboda]

added comments to #4059 few days ago

[rsvoboda]

category worked for quarkus-http based app ...

[gsmet]

OK, then, it's good to go and we need to address access logs for Vert.x based RESTEasy.

Comments addressed.

[rsvoboda]

@gsmet #5556
currently it has bug label, could be changed to enhancement