Doc Feedback:

Location : https://apim.docs.wso2.com/en/latest/
I trying configure ELK for APIM 4.2.0 and configure with document: https://apim.docs.wso2.com/en/latest/api-analytics/on-prem/elk-installation-guide but i don't write log to apim_metrics.logs and log for wso2carbon.log
2023-11-20T00:00:52,756 [-] [PassThroughMessageProcessor-332] ERROR AbstractRequestDataPublisher Error occurred when publishing event.
org.wso2.am.analytics.publisher.exception.MetricReportingException: userName is missing in metric data. This metric event will not be processed further.
at org.wso2.am.analytics.publisher.reporter.elk.ELKMetricEventBuilder.validate(ELKMetricEventBuilder.java:79) ~[org.wso2.am.analytics.publisher.client_1.2.3.jar:?]
at org.wso2.am.analytics.publisher.reporter.AbstractMetricEventBuilder.build(AbstractMetricEventBuilder.java:32) ~[org.wso2.am.analytics.publisher.client_1.2.3.jar:?]
at org.wso2.am.analytics.publisher.reporter.elk.ELKCounterMetric.incrementCount(ELKCounterMetric.java:49) ~[org.wso2.am.analytics.publisher.client_1.2.3.jar:?]
at org.wso2.carbon.apimgt.common.analytics.publishers.impl.AbstractRequestDataPublisher.publish(AbstractRequestDataPublisher.java:73) ~[org.wso2.carbon.apimgt.common.analytics_9.28.116.jar:?]
at org.wso2.carbon.apimgt.common.analytics.collectors.impl.SuccessRequestDataCollector.collectData(SuccessRequestDataCollector.java:95) ~[org.wso2.carbon.apimgt.common.analytics_9.28.116.jar:?]
at org.wso2.carbon.apimgt.common.analytics.collectors.impl.GenericRequestDataCollector.collectData(GenericRequestDataCollector.java:46) ~[org.wso2.carbon.apimgt.common.analytics_9.28.116.jar:?]
at org.wso2.carbon.apimgt.gateway.handlers.analytics.AnalyticsMetricsHandler.handleResponseOutFlow_aroundBody8(AnalyticsMetricsHandler.java:95) ~[org.wso2.carbon.apimgt.gateway_9.28.116.jar:?]
at org.wso2.carbon.apimgt.gateway.handlers.analytics.AnalyticsMetricsHandler.handleResponseOutFlow(AnalyticsMetricsHandler.java:1) ~[org.wso2.carbon.apimgt.gateway_9.28.116.jar:?]
at org.apache.synapse.core.axis2.Axis2Sender.sendBack(Axis2Sender.java:188) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.core.axis2.Axis2SynapseEnvironment.send(Axis2SynapseEnvironment.java:574) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.mediators.builtin.SendMediator.mediate(SendMediator.java:123) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.mediators.AbstractListMediator.mediate(AbstractListMediator.java:110) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.mediators.AbstractListMediator.mediate(AbstractListMediator.java:72) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.mediators.base.SequenceMediator.mediate(SequenceMediator.java:158) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.Resource.process(Resource.java:342) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.API.process(API.java:416) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.AbstractApiHandler.apiProcessNonDefaultStrategy(AbstractApiHandler.java:108) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.AbstractApiHandler.identifyAPI(AbstractApiHandler.java:128) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.AbstractApiHandler.dispatchToAPI(AbstractApiHandler.java:55) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.rest.RestRequestHandler.dispatchToAPI(RestRequestHandler.java:90) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.api.rest.RestRequestHandler.process(RestRequestHandler.java:63) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.rest.RESTRequestHandler.process(RESTRequestHandler.java:54) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.core.axis2.Axis2SynapseEnvironment.injectMessage(Axis2SynapseEnvironment.java:346) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.core.axis2.SynapseCallbackReceiver.handleMessage(SynapseCallbackReceiver.java:644) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.synapse.core.axis2.SynapseCallbackReceiver.receive(SynapseCallbackReceiver.java:219) ~[synapse-core_4.0.0.wso2v20.jar:4.0.0-wso2v20]
at org.apache.axis2.engine.AxisEngine.receive(AxisEngine.java:180) ~[axis2_1.6.1.wso2v83.jar:?]
at org.wso2.carbon.core.multitenancy.MultitenantMessageReceiver.processResponse(MultitenantMessageReceiver.java:189) ~[org.wso2.carbon.core_4.8.1.jar:?]
at org.wso2.carbon.core.multitenancy.MultitenantMessageReceiver.receive(MultitenantMessageReceiver.java:91) ~[org.wso2.carbon.core_4.8.1.jar:?]
at org.apache.axis2.engine.AxisEngine.receive(AxisEngine.java:180) ~[axis2_1.6.1.wso2v83.jar:?]
at org.apache.synapse.transport.passthru.ClientWorker.run(ClientWorker.java:304) ~[synapse-nhttp-transport_4.0.0.wso2v20.jar:?]
at org.apache.axis2.transport.base.threads.NativeWorkerPool$1.run(NativeWorkerPool.java:172) ~[axis2_1.6.1.wso2v83.jar:?]
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) ~[?:?]
at java.lang.Thread.run(Thread.java:833) [?:?]

Start with the ELK installation guide at https://apim.docs.wso2.com/en/latest/api-analytics/on-prem/elk-installation-guide and reproduce the APIM 4.2.0 setup described in the report. Check the missing userName error and the absence of apim_metrics.logs, then determine which configuration or troubleshooting steps the documentation lacks. Done means the guide explains the required setup and expected log output or clearly documents the limitation.