Contents

# alblogs

Utility script for processing ALB access logs over a given time range

### Requirements

Need to have the AWS CLI installed.  Can be found here https://aws.amazon.com/cli/

### Install

```
gem install alblogs
```

### Usage

```
Usage: alblogs [options]
    -s, --start=TIME_EXP             Start time
    -e, --end=TIME_EXP               End time
        --include=REGEX              Include filter
        --exclude=REGEX              Exclude filter
    -p, --profile=PROFILE            AWS profile
    -b, --bucket=ALB_S3_BUCKET       ALB S3 Bucket and Path
    -o, --output=OUTPUT_FILE         File to stream matching ALB log entries to
        --stats                      Display Stats
        --request-times-over=SECONDS Find requests that took over X seconds
```

### Example

Find all requests that took over 500ms to process in the last 12 hours.

```
alblogs -b 's3://<my-aws-alb-bucket-name>/access_logs/AWSLogs/<aws-account-id>/elasticloadbalancing/<aws-region>' -s '12 hours' -o slow-requests.log --request-times-over 0.5
```

### References

AWS Documentaion: Access Logs for Your Application Load Balancer

https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-access-logs.html

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
alblogs-0.2.0	README.md
alblogs-0.1.8	README.md
alblogs-0.1.7	README.md
alblogs-0.1.4	README.md
alblogs-0.1.2	README.md
alblogs-0.1.0	README.md