Skip to content
Rajiv Shivane edited this page Sep 25, 2017 · 11 revisions

Pre-requisites

  • An apptuit.ai account
  • Access token for your account

For RPM based distros

  1. Download and install latest version
    • Get the download link to latest .rpm package from the Releases Page
    • Download the package using the copied link
      wget https://github.com/ApptuitAI/xcollector/releases/download/apptuit-v0.6.0/xcollector-0.6-1.x86_64.rpm
    • Install the collector
      yum --nogpgcheck localinstall xcollector-0.6-1.x86_64.rpm
  2. Update token in the config
    • vi /etc/xcollector/xcollector.yml
    • Change access_token: "PASTE_ACCESS_TOKEN_HERE" to access_token: "<TOKEN>"
  3. XCollector adds a default "host" tag to all the metrics. You can add additional global tags (like environment="production" or data_center="us-east-1a" etc) to all the metrics generated on this instance. To add global tags:
    • vi /etc/xcollector/xcollector.yml
    • Un-comment the tags section and enable the tags relevant to your environment
  4. If you are running NGINX, verify log file format: NGiNXAccessLog
  5. If you are running Tomcat, change your log configuration as described in: TomcatAccessLog
  6. Start the collector:
    service xcollector start
  7. In case of trouble with XCollector on startup look at:
    service xcollector status
    /var/log/boot.log

For DEB based distros

  1. Download and install latest version
    • Get the download link to latest .deb package from the Releases Page
    • Download the package using the copied link
      wget https://github.com/ApptuitAI/xcollector/releases/download/apptuit-v0 .6.0/xcollector_0.6-1_amd64.deb
    • Install the collector
      sudo apt install ./xcollector_0.6-1_amd64.deb
  2. Update token in the config
    • vi /etc/xcollector/xcollector.yml
    • Change access_token: "PASTE_ACCESS_TOKEN_HERE" to access_token: "<TOKEN>"
  3. XCollector adds a default "host" tag to all the metrics. You can add additional global tags (like environment="production" or data_center="us-east-1a" etc) to all the metrics generated on this instance. To add global tags:
    • vi /etc/xcollector/xcollector.yml
    • Un-comment the tags section and enable the tags relevant to your environment
  4. If you are running NGINX, verify log file format: NGiNXAccessLog
  5. If you are running Tomcat, change your log configuration as described in: TomcatAccessLog
  6. Start the collector:
    sudo service xcollector start
  7. In case of trouble with XCollector on startup look at:
    service xcollector status
    /var/log/boot.log
Clone this wiki locally