====== JIRA ======
  This plugins allows to create tickets in JIRA based on generated Alerts
  You can control how tickets are going to be created, updated and closed
  
===== Configuration ======

  * Navigate to plugins, press ''Create'' and select JIRA

^ Parameters ^ Description ^
| Name |Plugin name|
|URL|the URL of your Jira instance (ex: https://redpeaks.atlassian.net)|
|User| The user associated to the API token|
|Password|The API token created for the user|
|JIRA project|The project key in which tickets are going to be created|
|Issue type|The full name of the type of issues to create (Incident,Service Request,...)|
|Summary|Defines the summary format of the tickets. Variables can be used to build a custom summary|
|Closed states|Ticket states representing a closed state (Closed, Finished, etc...)|

===== Credentials =====
  * The plugin requires to use basic authentication in order to use the JIRA API.
  * Therefore you must create **User API Token** associated to the user under which the ticket is going to be created.
  * We recommend creating the equivalent of a "service" user.
  * To create User API tokens:
    * Navigate to **Atlassian administration** portal
    * Open ''Security tab'' and look for ''User API Tokens'' in the left menu.
    * Create a new Token and use it as password in the Jira plugin configuration.

===== Raising Tickets =====
  * Any alarm received by the plugin will trigger the following actions:
    * Search in JIRA project if a ticket for the ''alarmId'' of the alarm already exists
    * If no ''Open'' ticket exists, then the plugin creates a new one
    * If a ticket exists, then the plugin updates the ticket, adding a new comment for the alarm.