andromedarabbit / bigbrother

Notify when IP addresses of AWS ELB are changed

bigbrother

Do you want to know how frequently your ELBs change their own IP addresses? bigbrother will help you to find out it!

IAM permissions

{
 "Version": "2012-10-17",
 "Statement": [
   {
     "Effect": "Allow",
     "Action": [
       "elasticloadbalancing:DescribeLoadBalancers"
     ],
     "Resource": [
       "*"
     ]
   }
 ]
}

How to configure

The following environment variables can be configured:

• SLEEP_TIME_IN_SECOND: not required, every 10 minute by default
• AWS_REGION: not required
• AWS_ACCESS_KEY_ID: not required
• AWS_SECRET_ACCESS_KEY: not required
• SLACK_TOKEN: required when you want to post a notification to your Slack channel
• SLACK_CHANNEL: not required, ops by default
• LOGGING_LEVEL: not required, WARNING by default, applied to Docker container only.

How to run on Docker

docker run andromedarabbit/bigbrother -e AWS_REGION=ap-northeast-1 -e AWS_ACCESS_KEY_ID=MY_KEY -e AWS_SECRET_ACCESS_KEY=MY_SECRET -e SLACK_TOKEN=MY_TOKEN -e SLACK_CHANNEL=ops -e LOGGING_LEVEL=INFO

How to run on Kubernetes

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: bigbrother
spec:
  replicas: 1
  strategy:
    type: Recreate
  template:
    metadata:
      labels:
        app: bigbrother
    spec:
      containers:
      - name: bigbrother
        image: andromedarabbit/bigbrother:latest
        env:
        - name: SLACK_TOKEN
          value: "MY_TOKEN"
        - name: SLACK_CHANNEL
          value: ops
        - name: LOGGING_LEVEL
          value: INFO

Thanks to

• nlopes/slack: Slack API in Go

See also

• Slack Legacy Tokens
• Slack Message Builder
• WeltN24/metrics-discovery: can be used in a monitoring systems like nagios or zabbix to discover items on aws
• hirose31/monitor-elb-address: check IP addresses of ELB periodically and notifies us when changed
• doublemarket/elbipchecker: ELB IP address change monitor script