[OTLP/OCB] Add e2e canary tests running on Java/EKS using OTLP endpoint (#328)

*Issue description:*

Add test case for OTLP+OCB testing
- Add e2e test Canary running in IAD in new OTLP specific test accounts
- Added validation files
- Note - The diffs compared to non-OTLP are numerous. [See majority of
the diffs
here](5622948).
- Added terraform files
- Include test resources specific for OTLP+OCB testing:
  - `terraform/java/eks-otlp-ocb/util/appsignals-collector.yaml`
- Contains OCB Collector and auto-instrumentation configurations for use
on EKS
  - `terraform/java/eks-otlp-ocb/util/enable-app-signals-ocb.sh`
- Enablement script to install OpenTelemetry Operator in EKS cluster and
sets up IAM Service Account.


Update Validator
- support `remoteServiceIp` input
- if provided, query metrics for remoteServiceNames with
`remoteServiceIp`
- Changes to
`validator/src/main/java/com/amazon/aoc/models/xray/Entity.java`
- Validate `metadata` as Map<String, Object> instead of Map<String,
Map<String, Object>>. This change is needed for OTLP+OCB test cases, and
has been validated to work with the existing non-OTLP test cases.

*Description of changes:*

*Rollback procedure:*

- We safely revert this commit if needed

*Ensure you've run the following tests on your changes and include the
link below:*

- Test ran in new OTLP account (Java+EKS):
https://github.com/aws-observability/aws-application-signals-test-framework/actions/runs/12058149370

- Run Java EKS on `e2e-playground` in us-east-1
https://github.com/aws-observability/aws-application-signals-test-framework/actions/runs/12061315729
- Run Python EKS on `e2e-playground` in us-east-1
https://github.com/aws-observability/aws-application-signals-test-framework/actions/runs/12061315729
- ~~Run metric limiter on EKS cluster `e2e-playground` in us-east-1 and
eu-central-2~~
- Run EC2 tests in all regions
https://github.com/aws-observability/aws-application-signals-test-framework/actions/runs/12060250860/job/33630333497
- ~~Run K8s on a separate K8s cluster (check IAD test account for master
node endpoints; these will change as we create and destroy clusters for
OS patching)~~

By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache 2.0 license.

---------

Co-authored-by: Mahad Janjua <[email protected]>

Author: jj22ee

.github/workflows/java-eks-otlp-ocb-canary.yml

@@ -0,0 +1,36 @@
+## Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+## SPDX-License-Identifier: Apache-2.0
+
+## This workflow aims to run the Application Signals end-to-end tests as a canary to
+## test the artifacts for App Signals enablement. It will deploy a sample app and remote
+## service onto an EKS cluster, instrumented using an OTel Collector built through
+## OTel Collector Builder (OCB) and interacting with the OTLP endpoint for this use case.
+## Logs, metrics, and traces are all validated.
+name: Java EKS OTLP/OCB Enablement Canary Test
+on:
+  schedule:
+    - cron: '12,37 * * * *' # run the workflow at 12th and 37th minute of every hour
+  workflow_dispatch: # be able to run the workflow on demand
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  eks:
+    strategy:
+      fail-fast: false
+      matrix:
+        aws-region: ['us-east-1']
+        # TODO: Reintroduce all regions
+        # aws-region: ['af-south-1','ap-east-1','ap-northeast-1','ap-northeast-2','ap-northeast-3','ap-south-1','ap-south-2','ap-southeast-1',
+        #              'ap-southeast-2','ap-southeast-3','ap-southeast-4','ca-central-1','eu-central-1','eu-central-2','eu-north-1',
+        #              'eu-south-1','eu-south-2','eu-west-1','eu-west-2','eu-west-3','il-central-1','me-central-1','me-south-1', 'sa-east-1',
+        #              'us-east-1','us-east-2','us-west-1','us-west-2']
+    uses: ./.github/workflows/java-eks-otlp-ocb-retry.yml
+    secrets: inherit
+    with:
+      aws-region: ${{ matrix.aws-region }}
+      test-cluster-name: 'e2e-java-otlp-ocb-canary-test'
+      caller-workflow-name: 'appsignals-java-e2e-eks-otlp-ocb-canary-test'
+      java-version: '11'

.github/workflows/java-eks-otlp-ocb-retry.yml

@@ -0,0 +1,71 @@
+## Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+## SPDX-License-Identifier: Apache-2.0
+
+# This is a reusable workflow for running the Enablement test for App Signals.
+# It is meant to be called from another workflow.
+# Read more about reusable workflows: https://docs.github.com/en/actions/using-workflows/reusing-workflows#overview
+name: Java EKS OTLP/OCB Retry
+on:
+  workflow_call:
+    inputs:
+      aws-region:
+        required: true
+        type: string
+      test-cluster-name:
+        required: true
+        type: string
+      caller-workflow-name:
+        required: true
+        type: string
+      java-version:
+        required: true
+        type: string
+
+concurrency:
+  group: 'java-eks-otlp-ocb-${{ inputs.aws-region }}-${{ github.ref_name }}'
+  cancel-in-progress: false
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  java-eks-otlp-ocb-attempt-1:
+    uses: ./.github/workflows/java-eks-otlp-ocb-test.yml
+    secrets: inherit
+    with:
+      aws-region: ${{ inputs.aws-region }}
+      test-cluster-name: ${{ inputs.test-cluster-name }}
+      caller-workflow-name: ${{ inputs.caller-workflow-name }}
+      java-version: ${{ inputs.java-version }}
+
+  java-eks-otlp-ocb-attempt-2:
+    needs: [ java-eks-otlp-ocb-attempt-1 ]
+    if: ${{ needs.java-eks-otlp-ocb-attempt-1.outputs.job-started != 'true' }}
+    uses: ./.github/workflows/java-eks-otlp-ocb-test.yml
+    secrets: inherit
+    with:
+      aws-region: ${{ inputs.aws-region }}
+      test-cluster-name: ${{ inputs.test-cluster-name }}
+      caller-workflow-name: ${{ inputs.caller-workflow-name }}
+      java-version: ${{ inputs.java-version }}
+
+  publish-metric-attempt-1:
+    needs: [ java-eks-otlp-ocb-attempt-1, java-eks-otlp-ocb-attempt-2 ]
+    if: always()
+    uses: ./.github/workflows/enablement-test-publish-result.yml
+    secrets: inherit
+    with:
+      aws-region: ${{ inputs.aws-region }}
+      caller-workflow-name: ${{ inputs.caller-workflow-name }}
+      validation-result: ${{ needs.java-eks-otlp-ocb-attempt-1.outputs.validation-result || needs.java-eks-otlp-ocb-attempt-2.outputs.validation-result }}
+
+  publish-metric-attempt-2:
+    needs: [ java-eks-otlp-ocb-attempt-1, java-eks-otlp-ocb-attempt-2, publish-metric-attempt-1 ]
+    if: ${{ always() && needs.publish-metric-attempt-1.outputs.job-started != 'true' }}
+    uses: ./.github/workflows/enablement-test-publish-result.yml
+    secrets: inherit
+    with:
+      aws-region: ${{ inputs.aws-region }}
+      caller-workflow-name: ${{ inputs.caller-workflow-name }}
+      validation-result: ${{ needs.java-eks-otlp-ocb-attempt-1.outputs.validation-result || needs.java-eks-otlp-ocb-attempt-2.outputs.validation-result }}