jira-analysis/README.md

1.1 KiB

Script to extract data from JIRA and pull it into a postgres DB for analysis.

Setup

  1. Install docker

  2. Generate an API token for your JIRA user.

  3. Pull the database container:

    make createdb
    

    Feel free to edit the Makefile to view or change the default username/password combination.

  4. Build the tool:

    nimble build
    

Usage

  • Start the database container:

    make startdb
    
  • Pull issues from your JIRA instance into the DB:

    ./jira_analysis api-sync <jira-base-url> <username> <api-token>
    
  • Connect to the database for analysis:

    make connect
    

Convenient PostgreSQL commands

From within a psql session:

  • Export tables to CSV:

    \copy features TO features-export.csv DELIMITER ',' CSV HEADER;
    \copy issues TO issues-export.csv DELIMITER ',' CSV HEADER;
    \copy change_logs TO changelog-export.csv DELIMITER ',' CSV HEADER;