docs: update 4.x branch for v4.11.0 release (take 2)

.github/dependabot.yml

@@ -48,15 +48,15 @@ updates:
         - "eslint*"
 
   - package-ecosystem: "npm"
-    directory: "/test/instrumentation/azure-functions/fixtures/AJsAzureFnApp"
+    directory: "/test/instrumentation/azure-functions/fixtures/azfunc3"
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 5
     reviewers:
       - "elastic/apm-agent-node-js"
 
   - package-ecosystem: "npm"
-    directory: "/test/instrumentation/modules/next/a-nextjs-app"
+    directory: "/test/instrumentation/azure-functions/fixtures/azfunc4"
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 5

.github/workflows/addToProject.yml

@@ -9,7 +9,7 @@ permissions:
 jobs:
   add_to_project:
     if: github.event.issue && github.event.issue.milestone
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - name: Get token
         id: get_token

.github/workflows/edge.yml

@@ -27,7 +27,7 @@ jobs:
   # made, these will stop and there will be no value in testing v17 nightlies.
   #
   test-nightly:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 30
     strategy:
       fail-fast: false
@@ -44,7 +44,7 @@ jobs:
   # The node.js project *sometimes* produces "rc" builds leading up to a new
   # release. They get uploaded to: https://nodejs.org/download/rc/
   test-rc:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 30
     strategy:
       fail-fast: false

.github/workflows/labeler.yml

@@ -13,7 +13,7 @@ permissions:
 
 jobs:
   triage:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
     - name: Get token
       id: get_token
@@ -33,7 +33,10 @@ jobs:
         github-token: ${{ steps.get_token.outputs.token }}
 
     - name: Add community and triage labels
-      if: contains(steps.is_elastic_member.outputs.result, 'false') && github.actor != 'dependabot[bot]' && github.actor != 'elastic-observability-automation[bot]'
+      if: contains(steps.is_elastic_member.outputs.result, 'false') &&
+        github.actor != 'dependabot[bot]' &&
+        github.actor != 'elastic-renovate-prod[bot]' &&
+        github.actor != 'elastic-observability-automation[bot]'
       uses: actions/github-script@v7
       with:
         script: |

.github/workflows/microbenchmark.yml

@@ -17,7 +17,7 @@ permissions:
 
 jobs:
   microbenchmark:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 5
     steps:
       - name: Run microbenchmark

.github/workflows/release.yml

@@ -15,7 +15,7 @@ permissions:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     env:
       DOCKER_IMAGE_NAME: docker.elastic.co/observability/apm-agent-nodejs
     steps:
@@ -63,7 +63,7 @@ jobs:
 
       - name: Build and Push Docker Image
         id: docker-push
-        uses: docker/build-push-action@48aba3b46d1b1fec4febb7c5d0c644b249a11355  # v6.10.0
+        uses: docker/build-push-action@67a2d409c0a876cbe6b11854e3e25193efe4e62d  # v6.12.0
         with:
           context: .
           platforms: linux/amd64,linux/arm64
@@ -97,7 +97,7 @@ jobs:
 
       - name: Build and Push Docker Image (wolfi)
         id: docker-push-wolfi
-        uses: docker/build-push-action@48aba3b46d1b1fec4febb7c5d0c644b249a11355  # v6.10.0
+        uses: docker/build-push-action@67a2d409c0a876cbe6b11854e3e25193efe4e62d  # v6.12.0
         with:
           context: .
           platforms: linux/amd64,linux/arm64

.github/workflows/slack.yml

@@ -0,0 +1,126 @@
+# Post a slack message something like the following for issue and PR actions:
+#     <$url|$title>
+#     | $repo#$num · issue opened by $user
+#
+# Configuration:
+# 1. Set `SLACK_CHANNEL`.
+# 2. Add a `SLACK_BOT_TOKEN` secret to your repo. This is the "Bot User OAuth
+#    Token" from the "OAuth & Permissions" section of your Slack App
+#    (https://api.slack.com/apps). The token must have the `chat:write`
+#    permission.
+# 3. Optionally tweak the `if:` and `on:` sections below to control which issue
+#    and PR events are skipped.
+
+name: slack
+
+env:
+  SLACK_CHANNEL: "#apm-agent-node"
+
+on:
+  issues:
+    types: [opened, reopened, closed]
+  pull_request:
+    types: [opened, ready_for_review, reopened, closed]
+
+jobs:
+  slack:
+    # Skip notification if:
+    # - dependabot or renovate PRs, too noisy
+    # - draft PRs
+    if: ${{ !(
+        (github.event.action == 'opened' && github.event.pull_request.draft) ||
+        github.event.pull_request.user.login == 'dependabot[bot]' ||
+        github.event.pull_request.user.login == 'elastic-renovate-prod[bot]'
+      ) }}
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Prepare Slack message
+        id: prepare
+        shell: python
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: |
+          import os
+          from pprint import pprint
+          import json
+
+          CLOSED_RED = '#cb2431'
+          GITHUB_BLACK = '#24292f'
+          MERGED_PURPLE = '#6f42c1'
+          OPEN_GREEN = '#36a64f'
+          DRAFT_GRAY = '#6a737d'
+
+          ctx = json.loads(os.environ["GITHUB_CONTEXT"])
+          # pprint(ctx) # for dev/debugging
+          event = ctx["event"]
+          action = event["action"]
+          if "issue" in event:
+            title = event["issue"]["title"]
+            url = event["issue"]["html_url"]
+            num = event["issue"]["number"]
+            action_str = f"issue {action}"
+            color = {
+              "opened": OPEN_GREEN,
+              "reopened": OPEN_GREEN,
+              "closed": CLOSED_RED,
+            }.get(action, "#ffffff")
+          elif "pull_request" in event:
+            title = event["pull_request"]["title"]
+            url = event["pull_request"]["html_url"]
+            num = event["pull_request"]["number"]
+            if action == "closed":
+              if event["pull_request"]["merged"]:
+                action_str = "PR merged"
+                color = MERGED_PURPLE
+              else:
+                action_str = "PR closed"
+                color = CLOSED_RED
+            elif event["pull_request"]["draft"]:
+              action_str = "PR in draft"
+              color = DRAFT_GRAY
+            elif action == "ready_for_review":
+              action_str = "PR ready for review"
+              color = OPEN_GREEN
+            else:
+              action_str = "PR opened"
+              color = OPEN_GREEN
+          else:
+            pprint(ctx)
+            raise ValueError('unexpected event: not an issue or PR event')
+
+          payload = {
+            "channel": os.environ["SLACK_CHANNEL"],
+
+            # Note: Omitting the "text" field is intentional, so that it is not
+            # rendered by default. Guidelines on accessibility in:
+            #   https://api.slack.com/methods/chat.postMessage#text-blocks-attachments
+            # are unclear for "attachments" usage. This competes with:
+            #   https://api.slack.com/reference/messaging/attachments#guidelines__message-attachments-as-objects
+            # guidelines to group all object data inside the attachment.
+            # The downside is that the `chatMessage` below results in warnings
+            # from the Slack API about not including the top-level "text".
+            #"text": title,
+
+            # Intentionally *not* using Slack's newer blocks,
+            #   https://api.slack.com/messaging/attachments-to-blocks
+            # because styling with the older syntax is slightly nicer, IMHO.
+            "attachments": [
+              {
+                "color": color,
+                "title": title,
+                "title_link": url,
+                "footer": f"{ctx['repository']}#{num} · *{action_str}* by {event['sender']['login']}",
+                "footer_icon": "https://github.githubassets.com/favicon.ico"
+              }
+            ]
+          }
+
+          with open(os.environ.get("GITHUB_OUTPUT"), "a") as f:
+            f.write("payload={}".format(json.dumps(payload)))
+
+      - name: Post Slack message
+        uses: slackapi/[email protected]
+        with:
+          method: chat.postMessage
+          token: ${{ secrets.SLACK_BOT_TOKEN }}
+          payload: ${{ steps.prepare.outputs.payload }}

.github/workflows/tav-command.yml

@@ -14,7 +14,7 @@ permissions:
 jobs:
   command-validation:
     if: startsWith(github.event.review.body, '/test tav')
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 5
     permissions:
       pull-requests: write
@@ -132,7 +132,7 @@ jobs:
 
   test-tav:
     needs: command-validation
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 40
     strategy:
       max-parallel: 15

.github/workflows/tav.yml

@@ -21,7 +21,7 @@ permissions:
 
 jobs:
   prepare-matrix:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 5
     outputs:
       permutations: ${{ steps.transform.outputs.permutations }}
@@ -59,7 +59,7 @@ jobs:
 
   test-tav:
     needs: prepare-matrix
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 40
     strategy:
       max-parallel: 15

.github/workflows/test-docs.yml

@@ -17,6 +17,6 @@ permissions:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - run: echo "No build required"

.github/workflows/test.yml

@@ -32,7 +32,7 @@ permissions:
 jobs:
 
   lint:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -164,7 +164,7 @@ jobs:
           - '16.0'
           - '14'
           - '14.17'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-node@v4
@@ -197,7 +197,7 @@ jobs:
   # failure if at least one job listed "needs" is not successful.
   test:
     if: always()
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     needs:
       - lint
       - test-vers

.github/workflows/updatecli.yml

@@ -10,7 +10,7 @@ permissions:
 
 jobs:
   compose:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     permissions:
       contents: read
       packages: read

.tav.yml

@@ -467,14 +467,20 @@ aws-sdk:
     - node test/instrumentation/modules/aws-sdk/dynamodb.test.js
 
 '@aws-sdk/client-s3':
-  versions:
-    # - 3.377.0 was a bad release (https://github.com/open-telemetry/opentelemetry-js-contrib/issues/1828#issuecomment-1834276719)
-    mode: max-7
-    include: '>=3.15.0 <4'
-    exclude: '3.377.0'
-  commands:
-    - node test/instrumentation/modules/@aws-sdk/client-s3.test.js
-  node: '>=14'
+  - versions:
+      # - 3.377.0 was a bad release (https://github.com/open-telemetry/opentelemetry-js-contrib/issues/1828#issuecomment-1834276719)
+      mode: max-5
+      include: '>=3.15.0 <3.723.0'
+      exclude: '3.377.0'
+    node: '>=14'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-s3.test.js
+  - versions:
+      mode: max-5
+      include: '>=3.723.0 <4'
+    node: '>=18'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-s3.test.js
 
 '@aws-sdk/client-dynamodb':
   versions:
@@ -485,20 +491,32 @@ aws-sdk:
   node: '>=14'
 
 '@aws-sdk/client-sns':
-  versions:
-    mode: max-7
-    include: '>=3.15.0 <4'
-  commands:
-    - node test/instrumentation/modules/@aws-sdk/client-sns.test.js
-  node: '>=14'
+  - versions:
+      mode: max-7
+      include: '>=3.15.0 <3.723.0'
+    node: '>=14'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-sns.test.js
+  - versions:
+      mode: max-5
+      include: '>=3.723.0 <4'
+    node: '>=18'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-sns.test.js
 
 '@aws-sdk/client-sqs':
-  versions:
-    mode: max-7
-    include: '>=3.15.0 <4'
-  commands:
-    - node test/instrumentation/modules/@aws-sdk/client-sqs.test.js
-  node: '>=14'
+  - versions:
+      mode: max-7
+      include: '>=3.15.0 <3.723.0'
+    node: '>=14'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-sqs.test.js
+  - versions:
+      mode: max-5
+      include: '>=3.723.0 <4'
+    node: '>=18'
+    commands:
+      - node test/instrumentation/modules/@aws-sdk/client-sqs.test.js
 
 # - [email protected] added its diagnostics_channel support.
 # - In [email protected] the `request.origin` property was added, which we need

.tool-versions

@@ -1 +1 @@
-updatecli v0.89.0
+updatecli v0.92.0