README.md

Application Performance Monitoring for Open Source S/Ws.

SCOUTER is an open source APM like new relic and appdynamics. (APM means application performance monitoring or application performance management.)

• Monitoring target (currently)

  • Java application - Web applications (on Tomcat, JBoss, Resin...), Standalone java applications
  • OS - Linux, Windows, Unix

• Monitoring target (to-be : contributing welcome)

  • Redis, Apach HTTPD, nginX, Nodejs ...

Users use application services on a system and the services use resources on the system. You should understand this context in order to manage the system performance efficiently. SCOUTER can help you.

• SCOUTER shows
  • Metrics about users : Active user, Recently used user, Today visitor
  • Metrics about services : Active service, TPS, Response time, Application profiles(method profile, sql profile, external call profile...)
  • Metrics about resources : Cpu, Memory, Network and Heap usage, Connection pools etc.

At a glance(Click to watch the video)

Documents

• Document home
• Quick start guide (Quick Installation of demo system)
• Installation
• Live demo
• How to analyze XLog View
• Customizable alarm - Alert plugins guide
• Client screen help

Download

• Latest Release

Modules

Official modules:

• Agent : gather performance information and send to the server

  • Java Agent (JVM Agent) : gathering profiles and performance metrics of JVM & Web application server(eg. Tomcat)...
  • Host Agent (OS Agent) : gathering performance metrics of Linux, Windows and OSX...
  • MariaDB Agent : [to be announced]

• Server (Collector) : save the performance metrics from agents. The data is streamed to clients.

• Client (Viewer) : client program based on RCP.

• Web API (Since @1.8.0) : scouter web apis to get counters, XLogs, profiles and another performance metrics via HTTP protocol.

  • Web API Guide

3rd-party Agent

• Pulse type agent : scouter-pulse-library
  • aws-monitor : gathering performance metrics of EC2, RDS, ELB from cloudwatch in AWS.

Plugins

• Server plugin

  • Sample

    • scouter-plugin-server-null : sample plugin prints out data collected

  • Alert

    • scouter-plugin-server-email : emails alerts from Scouter
    • scouter-plugin-server-telegram : transfer alerts from Scouter to telegram
    • scouter-plugin-server-slack : transfer alerts from Scouter to slack
    • scouter-plugin-server-line : transfer alerts from Scouter to line
    • scouter-plugin-server-dingtalk : transfer alerts from Scouter to dingtalk

  • Counter

    • scouter-plugin-server-influxdb : transfer performance data from Scouter to influxDB(time series DB)

• Agent plugin

  • TBD

Facebook

• Scouter APM : Facebook Scouter user group

How to contribute

• Notice : Pull request to develop branch only allowed.
• Refer to the development guide below.
  • Scouter developer guide
• Please note that you will have to complete a CLA for your first pull-request.

Q&A

• Google Groups

Blogging & Posts

• Scouter series #1 - Installation
• Scouter series #2 - basic monitoring(1/2)
• Scouter series #3 - basic monitoring(2/2)
• Applying Scouter APM to my service : by Kingbbode
• Effective monitoring by Scouter : by TMON
• Opensource performance monitoring, Scouter configurations : by SUN
• Scouter, InfluxDB, Grafana
• Build my own agents by scouter pulse

License

Licensed under the Apache License, Version 2.0