AWS Unassociated Elastic IP Address Idle Cost Leak Sentinel

id: aws-elastic-ip-unassociated-cost-sentinel
namespace: company.cloud

inputs:
  - id: aws_region
    type: STRING
    defaults: "us-east-1"
    description: Target AWS region.
  - id: unassociated_eip_threshold
    type: INT
    defaults: 0
    description: Maximum acceptable count of unallocated or unassociated Elastic IP
      addresses.

tasks:
  - id: audit_unassociated_eips
    type: io.kestra.plugin.aws.cli.AwsCLI
    region: "{{ inputs.aws_region }}"
    accessKeyId: "{{ secret('AWS_ACCESS_KEY_ID') }}"
    secretKeyId: "{{ secret('AWS_SECRET_ACCESS_KEY') }}"
    commands:
      - |
        aws ec2 describe-addresses --output json > /tmp/all_eips.json

        UNASSOCIATED_EIPS=$(jq '[.Addresses[] | select(.AssociationId == null) | {public_ip: .PublicIp, allocation_id: .AllocationId, domain: .Domain}]' /tmp/all_eips.json)
        UNASSOCIATED_COUNT=$(echo "$UNASSOCIATED_EIPS" | jq 'length')

        echo "::set-output name=unassociated_count::$UNASSOCIATED_COUNT::"
        echo "::set-output name=unassociated_list::$UNASSOCIATED_EIPS::"

  - id: evaluate_eip_waste
    type: io.kestra.plugin.core.flow.If
    condition: "{{ outputs.audit_unassociated_eips.vars.unassociated_count | int >
      inputs.unassociated_eip_threshold }}"
    then:
      - id: notify_finops_team
        type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
        url: "{{ secret('SLACK_WEBHOOK') }}"
        payload: |
          {
            "channel": "#finops-cost-alerts",
            "attachments": [
              {
                "color": "warning",
                "title": "⚠️ AWS Unassociated Elastic IP Address Cost Leak Alert",
                "text": "Detected *{{ outputs.audit_unassociated_eips.vars.unassociated_count }}* unassociated Elastic IP(s) in `{{ inputs.aws_region }}`. Unallocated addresses: {{ outputs.audit_unassociated_eips.vars.unassociated_list }}. Impact: AWS bills an hourly idle penalty fee for allocated Elastic IPs that are not actively bound to running EC2 or NAT instances.",
                "footer": "Kestra FinOps Sentinel • AWS Elastic IP"
              }
            ]
          }

errors:
  - id: alert_pipeline_failure
    type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
    url: "{{ secret('SLACK_WEBHOOK') }}"
    payload: |
      {
        "channel": "#finops-cost-alerts",
        "attachments": [
          {
            "color": "danger",
            "title": "⚠️ AWS Elastic IP Sentinel Execution Failed",
            "text": "The Elastic IP audit workflow failed. Please verify AWS credentials and ec2:DescribeAddresses permissions.",
            "footer": "Kestra Workflow Failure Sentinel"
          }
        ]
      }

triggers:
  - id: periodic_schedule
    type: io.kestra.plugin.core.trigger.Schedule
    cron: "0 8 * * 1"
    disabled: true