Stackstate-Gunicorn Integration

Overview

Capture Gunicorn metrics in Stackstate to:

  • Visualize your web server performance
  • Correlate the performance of Gunicorn with the rest of your applications

Configuration

To capture Gunicorn metrics you need to install the Stackstate Agent.

  1. Configure the Agent to connect to Gunicorn Edit conf.d/gunicorn.yaml

     init_config:
    
     instances:
         -   proc_name: my_web_app
    
  2. Restart the Agent
  3. Execute the info command and verify that the integration check has passed.The output of the command should contain a section similar to the following:

     Checks
     ======
    
       [...]
    
       gunicorn
       --------
           - instance #0 [OK]
           - Collected 8 metrics & 0 events
    

Not sure how to execute the last two steps? Visit the Agent Usage Guide for more detailed instructions.

For more details about configuring this integration refer to the following file(s) on GitHub:

Metrics

gunicorn.requests
(rate every 10 seconds)
The rate of requests received.
shown as request/second
gunicorn.workers
(gauge every 10 seconds)
Number of workers managed by the arbiter.
shown as worker
gunicorn.request.duration.95percentile
(gauge every 10 seconds)
The 95th percentile of request duration time.
shown as millisecond
gunicorn.request.duration.avg
(gauge every 10 seconds)
The average request duration time.
shown as millisecond
gunicorn.request.duration.count
(rate every 10 seconds)
The rate of requests received.
shown as request/second
gunicorn.request.duration.max
(gauge every 10 seconds)
The maximum request duration time.
shown as millisecond
gunicorn.request.duration.median
(gauge every 10 seconds)
The median request duration time.
shown as millisecond
gunicorn.log.critical
(rate every 10 seconds)
The rate of logged critical statements.
shown as occurrence/second
gunicorn.log.error
(rate every 10 seconds)
The rate of logged errors.
shown as occurrence/second
gunicorn.log.warning
(rate every 10 seconds)
The rate of logged warnings.
shown as occurrence/second
gunicorn.log.exception
(rate every 10 seconds)
The rate of logged exceptions.
shown as occurrence/second
gunicorn.request.status.100
(rate every 10 seconds)
The rate of requests that generate responses with a 100 status code.
shown as request/second
gunicorn.request.status.101
(rate every 10 seconds)
The rate of requests that generate responses with a 101 status code.
shown as request/second
gunicorn.request.status.102
(rate every 10 seconds)
The rate of requests that generate responses with a 102 status code.
shown as request/second
gunicorn.request.status.200
(rate every 10 seconds)
The rate of requests that generate responses with a 200 status code.
shown as request/second
gunicorn.request.status.201
(rate every 10 seconds)
The rate of requests that generate responses with a 201 status code.
shown as request/second
gunicorn.request.status.202
(rate every 10 seconds)
The rate of requests that generate responses with a 202 status code.
shown as request/second
gunicorn.request.status.203
(rate every 10 seconds)
The rate of requests that generate responses with a 203 status code.
shown as request/second
gunicorn.request.status.204
(rate every 10 seconds)
The rate of requests that generate responses with a 204 status code.
shown as request/second
gunicorn.request.status.205
(rate every 10 seconds)
The rate of requests that generate responses with a 205 status code.
shown as request/second
gunicorn.request.status.206
(rate every 10 seconds)
The rate of requests that generate responses with a 206 status code.
shown as request/second
gunicorn.request.status.207
(rate every 10 seconds)
The rate of requests that generate responses with a 207 status code.
shown as request/second
gunicorn.request.status.208
(rate every 10 seconds)
The rate of requests that generate responses with a 208 status code.
shown as request/second
gunicorn.request.status.226
(rate every 10 seconds)
The rate of requests that generate responses with a 226 status code.
shown as request/second
gunicorn.request.status.300
(rate every 10 seconds)
The rate of requests that generate responses with a 300 status code.
shown as request/second
gunicorn.request.status.301
(rate every 10 seconds)
The rate of requests that generate responses with a 301 status code.
shown as request/second
gunicorn.request.status.302
(rate every 10 seconds)
The rate of requests that generate responses with a 302 status code.
shown as request/second
gunicorn.request.status.303
(rate every 10 seconds)
The rate of requests that generate responses with a 303 status code.
shown as request/second
gunicorn.request.status.304
(rate every 10 seconds)
The rate of requests that generate responses with a 304 status code.
shown as request/second
gunicorn.request.status.305
(rate every 10 seconds)
The rate of requests that generate responses with a 305 status code.
shown as request/second
gunicorn.request.status.307
(rate every 10 seconds)
The rate of requests that generate responses with a 307 status code.
shown as request/second
gunicorn.request.status.308
(rate every 10 seconds)
The rate of requests that generate responses with a 308 status code.
shown as request/second
gunicorn.request.status.400
(rate every 10 seconds)
The rate of requests that generate responses with a 400 status code.
shown as request/second
gunicorn.request.status.401
(rate every 10 seconds)
The rate of requests that generate responses with a 401 status code.
shown as request/second
gunicorn.request.status.402
(rate every 10 seconds)
The rate of requests that generate responses with a 402 status code.
shown as request/second
gunicorn.request.status.403
(rate every 10 seconds)
The rate of requests that generate responses with a 403 status code.
shown as request/second
gunicorn.request.status.404
(rate every 10 seconds)
The rate of requests that generate responses with a 404 status code.
shown as request/second
gunicorn.request.status.405
(rate every 10 seconds)
The rate of requests that generate responses with a 405 status code.
shown as request/second
gunicorn.request.status.406
(rate every 10 seconds)
The rate of requests that generate responses with a 406 status code.
shown as request/second
gunicorn.request.status.407
(rate every 10 seconds)
The rate of requests that generate responses with a 407 status code.
shown as request/second
gunicorn.request.status.408
(rate every 10 seconds)
The rate of requests that generate responses with a 408 status code.
shown as request/second
gunicorn.request.status.409
(rate every 10 seconds)
The rate of requests that generate responses with a 409 status code.
shown as request/second
gunicorn.request.status.410
(rate every 10 seconds)
The rate of requests that generate responses with a 410 status code.
shown as request/second
gunicorn.request.status.411
(rate every 10 seconds)
The rate of requests that generate responses with a 411 status code.
shown as request/second
gunicorn.request.status.412
(rate every 10 seconds)
The rate of requests that generate responses with a 412 status code.
shown as request/second
gunicorn.request.status.413
(rate every 10 seconds)
The rate of requests that generate responses with a 413 status code.
shown as request/second
gunicorn.request.status.414
(rate every 10 seconds)
The rate of requests that generate responses with a 414 status code.
shown as request/second
gunicorn.request.status.415
(rate every 10 seconds)
The rate of requests that generate responses with a 415 status code.
shown as request/second
gunicorn.request.status.416
(rate every 10 seconds)
The rate of requests that generate responses with a 416 status code.
shown as request/second
gunicorn.request.status.417
(rate every 10 seconds)
The rate of requests that generate responses with a 417 status code.
shown as request/second
gunicorn.request.status.419
(rate every 10 seconds)
The rate of requests that generate responses with a 419 status code.
shown as request/second
gunicorn.request.status.421
(rate every 10 seconds)
The rate of requests that generate responses with a 421 status code.
shown as request/second
gunicorn.request.status.422
(rate every 10 seconds)
The rate of requests that generate responses with a 422 status code.
shown as request/second
gunicorn.request.status.423
(rate every 10 seconds)
The rate of requests that generate responses with a 423 status code.
shown as request/second
gunicorn.request.status.424
(rate every 10 seconds)
The rate of requests that generate responses with a 424 status code.
shown as request/second
gunicorn.request.status.426
(rate every 10 seconds)
The rate of requests that generate responses with a 426 status code.
shown as request/second
gunicorn.request.status.428
(rate every 10 seconds)
The rate of requests that generate responses with a 428 status code.
shown as request/second
gunicorn.request.status.429
(rate every 10 seconds)
The rate of requests that generate responses with a 429 status code.
shown as request/second
gunicorn.request.status.431
(rate every 10 seconds)
The rate of requests that generate responses with a 431 status code.
shown as request/second
gunicorn.request.status.451
(rate every 10 seconds)
The rate of requests that generate responses with a 451 status code.
shown as request/second
gunicorn.request.status.500
(rate every 10 seconds)
The rate of requests that generate responses with a 500 status code.
shown as request/second
gunicorn.request.status.501
(rate every 10 seconds)
The rate of requests that generate responses with a 501 status code.
shown as request/second
gunicorn.request.status.502
(rate every 10 seconds)
The rate of requests that generate responses with a 502 status code.
shown as request/second
gunicorn.request.status.503
(rate every 10 seconds)
The rate of requests that generate responses with a 503 status code.
shown as request/second
gunicorn.request.status.504
(rate every 10 seconds)
The rate of requests that generate responses with a 504 status code.
shown as request/second
gunicorn.request.status.505
(rate every 10 seconds)
The rate of requests that generate responses with a 505 status code.
shown as request/second
gunicorn.request.status.506
(rate every 10 seconds)
The rate of requests that generate responses with a 506 status code.
shown as request/second
gunicorn.request.status.507
(rate every 10 seconds)
The rate of requests that generate responses with a 507 status code.
shown as request/second
gunicorn.request.status.508
(rate every 10 seconds)
The rate of requests that generate responses with a 508 status code.
shown as request/second
gunicorn.request.status.510
(rate every 10 seconds)
The rate of requests that generate responses with a 510 status code.
shown as request/second
gunicorn.request.status.511
(rate every 10 seconds)
The rate of requests that generate responses with a 511 status code.
shown as request/second
gunicorn.request.status.512
(rate every 10 seconds)
The rate of requests that generate responses with a 512 status code.
shown as request/second