Zorka

This manual refers to Atlassian JIRA but other Atlassian products (eg. Confluence) are built in similar way, so it is possible to use this instruction with other products.

Installing agent

Atlassian JIRA is distributed with application server (eg. Tomcat), in order to install agent on JIRA, follow application server instruction, eg. Tomcat. Also, JIRA uses OSGi inside, so it is mandatory to add com.jitlogic.zorka.core.spy package to OSGi boot delegation path (atlassian.org.osgi.framework.bootdelegation.extra property).

For example in Tomcat case two lines should be added to setenv.sh.

CATALINA_OPTS="$CATALINA_OPTS -javaagent:/opt/atlassian/jira/zorka/zorka.jar=/opt/atlassian/jira/zorka"
CATALINA_OPTS="$CATALINA_OPTS -Datlassian.org.osgi.framework.bootdelegation.extra=weblogic,weblogic.*,META-INF.services,com.yourkit,com.yourkit.*,com.chronon,com.chronon.*,org.jboss.byteman,org.jboss.byteman.*,com.jprofiler,com.jprofiler.*,org.apache.xerces,org.apache.xerces.*,org.apache.xalan,org.apache.xalan.*,org.apache.xml.serializer,sun.*,com.sun.xml.bind.v2,com.sun.xml.internal.bind.v2,com.icl.saxon,com_cenqua_clover,com.cenqua.clover,com.cenqua.clover.*,com.atlassian.clover,com.atlassian.clover.*,com.jitlogic.zorka.core.spy"

Monitoring JIRA HTTP API using HTTP Tags

Some basic functionalities can be determined using request URLs and properly classified using HTTP tags feature implemented in Zorka agent. When monitoring with Zabbix, Template_Zorka_HTTP_Tags_Active.xml template can be used (distributed with agent). Note that template requires active agent mode to be working, but it can be modified to use standard agent mode. Following settings need be added to zorka.properties:

http.tags = yes

http.tags.1 = rest
http.tags.1.uri = ^.rest.*
http.tags.1.desc = REST API

http.tags.2 = attach
http.tags.2.uri = .*Attach.*File.*
http.tags.2.desc = File Attachments Upload

http.tags.3 = issue
http.tags.3.uri = .browse.[A-Z]+.[0-9]+
http.tags.3.desc = Browsing Issues

http.tags.4 = static
http.tags.4.uri = .*(css|js|png|gif|ico|jpg|jpeg)$
http.tags.4.desc = Static Content

http.tags.5 = create_issue
http.tags.5.uri = .*QuickCreateIssue.jspa$
http.tags.5.desc = Issue Creation

http.tags.6 = create_issue_helper
http.tags.6.uri = .*QuickCreateIssue.default.jspa$
http.tags.6.desc = Issue Creation helper

http.tags.7 = dw_attachment
http.tags.7.uri = ^.secure.attachment.[0-9]+.*
http.tags.7.desc = File Attachments Download

http.tags.8 = issues_edited
http.tags.8.uri = .*QuickEditIssue.jspa$
http.tags.8.desc = Issue Edits

http.tags.9 = excel_reports_generated
http.tags.9.uri = .*searchrequest.excel.all.fields.*
http.tags.9.desc = Excel Reports Generation

http.tags.10 = comments_added
http.tags.10.uri = .*secure.AddComment.*
http.tags.10.desc = Adding Comments

http.tags.11 = emails_sent
http.tags.11.uri = .*secure.com.metainf.jira.plugin.emailissue.action.EmailThisIssue.*
http.tags.11.desc = Sending e-mails

http.tags.12 = attachments_accessed
http.tags.12.uri = .*secure.rest.api.latest.issue.*attachments.*
http.tags.12.desc = Attachment Access

Monitoring Atlassian JIRA

Installing agent

Monitoring JIRA HTTP API using HTTP Tags