MuleSoft Surat Virtual Meetup#7 - JSON Logger and Common Error Handling With MuleSoft

1. [Surat] MuleSoft Meetup Group
JSON Logger and Common Error Handling With MuleSoft
[16th Jan 2021]

2. 2
Organizers
A SHOW OF HANDS:
Who is new to this Meetup?
Jitendra Bafna
Senior Solution Architect
Capgemini
Nitish Jain
Consultant
IBM

3. 3
Speakers
Jitendra Bafna
Senior Solution Architect
Capgemini

4. 4

5. Agenda
 What is JSON Logger?
 Publishing JSON Logger to Anypoint Exchange
 JSON Logger Attributes
 Common Error Handling.
 Publishing Error Handling Framework to Anypoint Exchange
 Add Error Handling dependencies in MuleSoft application

6. What is JSON Logger?
● JSON Logger is basically used for logging the message, content in the JSON format. As
logging is very important part of your application but most of the time it is ignored and not
consider as an second citizen and it is taken as an granted.
● Logging is very essential part of your application and it is very important during any
production issue or for troubleshooting.
● MuleSoft provides out-of-box Logger components and it is very easy to use but JSON
logger provides structured way of logging the data.
● JSON Logger can be integrate with third parties tools like Splunk, ELK etc.

7. Features Of JSON Logger
JSON Logger provides various capabilities
● Logging the message, content.
● Masking the sensitive data in payload before logging.
● DataWeave Functions.
● Sending logs to External Destination like JMS, AMQP etc.
7

8. Publishing JSON Logger to Anypoint Exchange
Make sure Git is installed on your Desktop.
Step 1: - Clone the Git Repositories JSON Logger to local
git clone https://github.com/mulesoft-consulting/json-logger.git
Step 2: - Add Entry in setting.xml in .m2 repository
Step 3: - Publishing JSON Logger to Anypoint Exchange
./deploy-to-exchange.sh <Anypoint_Org_Id>
8
<servers>
<server>
<id>Exchange2</id>
<username>Anypoint_Username</username>
<password>Anypoint_Password</password>
</server>
</servers>

9. JSON Logger Configuration
9

10. • Live Demonstration
- Publishing JSON Logger To Anypoint Exchange
- Implementing JSON Logger in MuleSoft Application
- Masking Data in Payload
- Disabled Fields
- Sending Logs to External Systems (Apache Active MQ)

11. JSON Logger References
 https://blogs.mulesoft.com/dev-guides/how-to-tutorials/json-logging-mule-4/
 https://blogs.mulesoft.com/dev-guides/json-logging-in-mule-4/
 https://youtu.be/tM4gROClm10
 https://github.com/mulesoft-consulting/json-logger.git
11

12. Publish Artifacts to Anypoint Exchange
Step 1 – Add MuleRepository credentials in settings.xml located at .m2 folder.
Step 2 – Add Distribution Management in POM.xml
12
<servers>
<server>
<id>MuleRepository</id>
<username>Anypoint_Username</username>
<password>Anypoint_Password</password>
</server>
</servers>
<distributionManagement>
<repository>
<id>MuleRepository</id>
<name>Corporate Repository</name>
<url>https://maven.anypoint.mulesoft.com/api/v1/organizations/<orgId>/maven</url>
<layout>default</layout>
</repository>
</distributionManagement>

13. Publish Artifacts to Anypoint Exchange
Step 3 – Add classifier as mule-plugin for Mule-Maven-Plugin
Step 4 - Update GroupId as Organization Id in POM.xml
Step 5 – Execute mvn deploy
13
<plugin>
<groupId>org.mule.tools.maven</groupId>
<artifactId>mule-maven-plugin</artifactId>
<version>${mule.maven.plugin.version}</version>
<extensions>true</extensions>
<configuration>
<classifier>mule-plugin</classifier>
</configuration>
</plugin>

14. Publish Artifacts to Nexus
Step 1 – Add NexusRepository credentials in settings.xml located at .m2 folder.
Step 2 – Add Distribution Management in POM.xml
14
<servers>
<server>
<id>NexusRepository</id>
<username>Anypoint_Username</username>
<password>Anypoint_Password</password>
</server>
</servers>
<distributionManagement>
<repository>
<id>NexusRepository</id>
<name>Nexus Repository</name>
<url>http://localhost:8081/repository/maven-releases/</url>
</repository></distributionManagement>

15. Publish Artifacts to Nexus
Step 4 – Add Plugin to POM.xml
15
<plugin>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.8.1</version>
<executions>
<execution>
<id>default-deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.8.1</version>
<configuration>
<skip>true</skip>
</configuration>
</plugin>
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.5.1</version>
<executions>
<execution>
<id>default-deploy</id>
<phase>deploy</phase>
<goals>
<goal>deploy</goal>
</goals>
</execution>
</executions>
<configuration>
<serverId>nexus</serverId>
<nexusUrl>http://localhost:8081/nexus/</nexusUrl>
<skipStaging>true</skipStaging>
</configuration>
</plugin>

16. Publish Artifacts to Nexus
Step 5 – Execute mvn deploy
mvn deploy
16

17. Consuming Artifacts from Nexus
Step 1 – Add Artifacts Dependency in Application POM.xml
Step 2 – Add Nexus Repository in POM.xml
17
<dependency>
<groupId>1cb436ed-a889-4fc0-9714-8acdc6a18f22</groupId>
<artifactId>error-handling-common-utility</artifactId>
<version>1.0.0</version>
<classifier>mule-plugin</classifier>
</dependency>
<repository>
<id>Nexus</id>
<name>Mule Nexus Repository</name>
<url>http://localhost:8081/repository/maven-releases/</url>
<layout>default</layout>
</repository>

18. Live Demonstration
- Creating Common Error Handling Framework
- Publishing Common Error Handling Framework to Anypoint
Exchange
- Import Common Error Handling in MuleSoft Application
- Publishing Common Error Handling Framework to Nexus