docs/sections/services/mapper/troubleshooting.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 .. _troubleshooting:
   5
   6 Troubleshooting
   7 ===============
   8
   9 **NOTE**
  10
  11 According to **ONAP** logging policy, **Mapper** logs contain all required markers as well as service and client specific Mapped Diagnostic Context (later referred as MDC)
  12
  13 Default console log pattern:
  14
  15 ::
  16
  17         |%date{&quot;HH:mm:ss.SSSXXX&quot;, UTC}\t[ %thread\t] %highlight(%-5level)\t - %msg\t
  18
  19 A sample, fully qualified message implementing this pattern:
  20
  21 ::
  22
  23         |11:10:13.230 [rcc-notification] INFO metricsLogger - fetch and publish from and to Dmaap started:rcc-notification
  24
  25
  26 For simplicity, all log messages in this section are shortened to contain only:
  27     * logger name
  28     * log level
  29     * message
  30
  31 Error and warning logs contain also:
  32     * exception message
  33     * stack trace
  34
  35 **Do not rely on exact log messages or their presence, as they are often subject to change.**
  36
  37 Deployment/Installation errors
  38 --------------------
  39
  40 **Missing Default Config File in case of using local config instead of Consul**
  41
  42 ::
  43
  44
  45    |13:04:37.535 [main] ERROR errorLogger - Default Config file kv.json is missing
  46    |13:04:37.537 [main] ERROR errorLogger - Application stoped due to missing default Config file
  47    |13:04:37.538 [main] INFO  o.s.s.c.ThreadPoolTaskExecutor - Shutting down ExecutorService 'applicationTaskExecutor'
  48    |15:40:43.982 [main] WARN  debugLogger - All Smooks objects closed
  49 **These log messages are printed when the default configuration file "kv.json", was not present.**
  50
  51
  52
  53 **Invalid Default Config File in case of using local config instead of Consul**
  54
  55 If Default Config File  is an invalid json file, we will get below exception
  56
  57 ::
  58
  59  |15:19:52.489 [main] ERROR o.s.boot.SpringApplication - Application run failed
  60  |java.lang.IllegalStateException: Failed to execute CommandLineRunner
  61         at org.springframework.boot.SpringApplication.callRunner(SpringApplication.java:816)
  62         at org.springframework.boot.SpringApplication.callRunners(SpringApplication.java:797)
  63         at org.springframework.boot.SpringApplication.run(SpringApplication.java:324)
  64         at org.springframework.boot.SpringApplication.run(SpringApplication.java:1260)
  65         at org.springframework.boot.SpringApplication.run(SpringApplication.java:1248)
  66         at org.onap.universalvesadapter.Application.main(Application.java:29)
  67  |Caused by: org.json.JSONException: Expected a ',' or '}' at 8100 [character 2 line 54]
  68         at org.json.JSONTokener.syntaxError(JSONTokener.java:433)
  69         at org.json.JSONObject.<init>(JSONObject.java:229)
  70         at org.json.JSONObject.<init>(JSONObject.java:321)
  71         at org.onap.universalvesadapter.utils.FetchDynamicConfig.verifyConfigChange(FetchDynamicConfig.java:97)
  72         at org.onap.universalvesadapter.utils.FetchDynamicConfig.cbsCall(FetchDynamicConfig.java:66)
  73         at org.onap.universalvesadapter.service.VESAdapterInitializer.run(VESAdapterInitializer.java:83)
  74         at org.springframework.boot.SpringApplication.callRunner(SpringApplication.java:813)
  75         ... 5 common frames omitted
  76  |15:19:52.492 [main] INFO  o.s.s.c.ThreadPoolTaskExecutor - Shutting down ExecutorService 'applicationTaskExecutor'
  77  |15:19:52.493 [main] WARN  debugLogger - All Smooks objects closed
  78
  79
  80 **Invalid Smooks mapping file**
  81
  82 If VES-Mapper blueprint or local config file contains invalid Smooks mapping file, then we will get below SAXException / JsonProcessingException / JsonSyntaxException / JsonParseException while processing the incoming notifications and the notification will be dropped without converting into required VES event. All such dropped notifications will be logged in error log file.