elastic-apm 4.6.2 → 4.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7c28585ab44cfdb7a4eb8c32b8dd60e1ecb10c091357c25a6b13f35a0fe2ffc
-  data.tar.gz: 3aad55a03f8c2a4d824ea09731be304e7712ee306dc4e585c5cc29ba11e25413
+  metadata.gz: 0fb7f8389ec374ccb57a8496ba24e365006ce44590d4ab064763133c8129cdf4
+  data.tar.gz: 4010d4aeaea7c13d15cfd6a0fce757ab1d7477b5be7a72d350012a07a6b473a6
 SHA512:
-  metadata.gz: eb6480a61567bd000e5325e12702c46882a42a9c452a60bd7af997b7138b076cd332d853f101b694af30d120bdd3b48f1b911feb6ecf12e94cdfc58ba096855c
-  data.tar.gz: e626d4a1cb9370780d764385585fb4c4025d612a84b7ef36ae0525f6d6f6a83ddf7d5aa670ccf2610bf10f9e2c2d9a87f2f97818cc9e8de27153c3a85cd34875
+  metadata.gz: 5e0a026ec99b9ccd90c2f17ce4929cc583dc331582a9ad5e64b71410c0099da6f8478d3306c72d8cd9031d8c728f86d663325fdafe16381dd15a0302317fd747
+  data.tar.gz: 3df0f2d41ab038328f30ddbf7e88e2a3c0708004b64de06df165bfb073dde2bf37a546cf4b6a3c3f7c5971ff27698094cf48f480df96dff2c639b3b6986d47af

data/.ci/.exclude.yml

@@ -0,0 +1,193 @@
+exclude:
+  # Ruby 2.4
+  # Only test on rails-4.2, sinatra-1.4
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-7.0
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-6.1
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-6.0
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-5.2
+  - VERSION: ruby:2.4
+    FRAMEWORK: sinatra-2.2
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-1.6
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.0
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-main
+  - VERSION: ruby:2.4
+    FRAMEWORK: sinatra-main
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-master
+
+  # rails-4.2 exclusions
+  # Only test on ruby 2.4
+  - VERSION: ruby:3.1
+    FRAMEWORK: rails-4.2
+  - VERSION: ruby:3.0
+    FRAMEWORK: rails-4.2
+  - VERSION: ruby:2.7
+    FRAMEWORK: rails-4.2
+  - VERSION: ruby:2.6
+    FRAMEWORK: rails-4.2
+  - VERSION: jruby:9.2
+    FRAMEWORK: rails-4.2
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: rails-4.2
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: rails-4.2
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: rails-4.2
+  # sinatra-1.4 exclusions
+  - VERSION: ruby:3.1
+    FRAMEWORK: sinatra-1.4
+  - VERSION: ruby:3.0
+    FRAMEWORK: sinatra-1.4
+  - VERSION: ruby:2.7
+    FRAMEWORK: sinatra-1.4
+  - VERSION: jruby:9.2
+    FRAMEWORK: sinatra-1.4
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: sinatra-1.4
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: sinatra-1.4
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: sinatra-1.4
+
+  # rails-6.0 and rails-6.1 exclusions
+  # Don't test on ruby 2.4
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-6.1
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-6.0
+
+  # Only test rails main on ruby 3.1
+  - VERSION: ruby:3.0
+    FRAMEWORK: rails-main
+  - VERSION: ruby:2.7
+    FRAMEWORK: rails-main
+  - VERSION: ruby:2.6
+    FRAMEWORK: rails-main
+  - VERSION: ruby:2.5
+    FRAMEWORK: rails-main
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-main
+  - VERSION: jruby:9.2
+    FRAMEWORK: rails-main
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: rails-main
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: rails-main
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: rails-main
+
+  # Only test rails 7.0 on ruby >= 2.7
+  - VERSION: ruby:2.6
+    FRAMEWORK: rails-7.0
+  - VERSION: ruby:2.5
+    FRAMEWORK: rails-7.0
+  - VERSION: ruby:2.4
+    FRAMEWORK: rails-7.0
+  - VERSION: jruby:9.2
+    FRAMEWORK: rails-7.0
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: rails-7.0
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: rails-7.0
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: rails-7.0
+
+  # Only test sinatra main on ruby 2.7 and ruby 3.1
+  - VERSION: ruby:3.0
+    FRAMEWORK: sinatra-main
+  - VERSION: ruby:2.6
+    FRAMEWORK: sinatra-main
+  - VERSION: ruby:2.5
+    FRAMEWORK: sinatra-main
+  - VERSION: ruby:2.4
+    FRAMEWORK: sinatra-main
+  - VERSION: jruby:9.2
+    FRAMEWORK: sinatra-main
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: sinatra-main
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: sinatra-main
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: sinatra-main
+
+  # Only test grape master on ruby 2.7 and ruby 3.0
+  - VERSION: ruby:2.6
+    FRAMEWORK: grape-master
+  - VERSION: ruby:2.5
+    FRAMEWORK: grape-master
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-master
+  - VERSION: jruby:9.2
+    FRAMEWORK: grape-master
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: grape-master
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: grape-master
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: grape-master
+
+  # grape 1.5 doesn't support ruby 3.0
+  - VERSION: ruby:3.1
+    FRAMEWORK: grape-1.6
+  - VERSION: ruby:3.1
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  - VERSION: ruby:3.1
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: ruby:3.0
+    FRAMEWORK: grape-1.6
+  - VERSION: ruby:3.0
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+
+  # only test ruby >= 3.0 with rails 6.0 and rails 6.1
+  - VERSION: ruby:3.1
+    FRAMEWORK: rails-5.2
+  - VERSION: ruby:3.1
+    FRAMEWORK: rails-5.1
+  - VERSION: ruby:3.0
+    FRAMEWORK: rails-5.2
+  - VERSION: ruby:3.0
+    FRAMEWORK: rails-5.1
+
+  # Unsupported
+  # Ruby 2.6
+  - VERSION: ruby:2.6
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: ruby:2.6
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # Ruby 2.5
+  - VERSION: ruby:2.5
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: ruby:2.5
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # Ruby 2.4
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: ruby:2.4
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # JRuby 9.2
+  - VERSION: jruby:9.2
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: jruby:9.2
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # JRuby 9.2-13-jdk
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: elasticobservability/jruby:9.2-13-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # JRuby 9.2-11-jdk
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: elasticobservability/jruby:9.2-11-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0
+  # JRuby 9.2-8-jdk
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-6.1
+  - VERSION: elasticobservability/jruby:9.2-8-jdk
+    FRAMEWORK: grape-1.6,sinatra-2.2,rails-7.0

data/.ci/.ruby.yml

@@ -0,0 +1,10 @@
+VERSION:
+  - ruby:3.1
+  - ruby:3.0
+  - ruby:2.7
+  - ruby:2.6
+  - ruby:2.4
+  - jruby:9.2
+  - elasticobservability/jruby:9.2-13-jdk
+  - elasticobservability/jruby:9.2-11-jdk
+  - elasticobservability/jruby:9.2-8-jdk

data/.ci/scripts/bench.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+
+# Bash strict mode
+set -eo pipefail
+
+# Found current script directory
+RELATIVE_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
+
+# Found project directory
+BASE_PROJECT="$(dirname "$(dirname "${RELATIVE_DIR}")")"
+
+## Buildkite specific configuration
+if [ "$CI" == "true" ] ; then
+  # If HOME is not set then use the Buildkite workspace
+  # that's normally happening when running in the CI
+  # owned by Elastic.
+  if [ -z "$HOME" ] ; then
+    HOME=$BUILDKITE_BUILD_CHECKOUT_PATH
+    export HOME
+  fi
+
+  # required when running the benchmark
+  PATH=$PATH:$HOME/.local/bin
+  export PATH
+
+  echo 'Docker login is done in the Buildkite hooks'
+fi
+
+# It does not fail so it runs for every single version and then we report the error at the end.
+set +e
+status=0
+
+for VERSION in "ruby:3.1" "ruby:3.0" "ruby:2.7" "ruby:2.6" "jruby:9.2" ; do
+    ## Transform the versions like:
+    ## jruby:9.1 to jruby-9.1
+  echo "--- Benchmark for :ruby: ${VERSION}"
+  OUTPUT_NAME=benchmark-$(echo "${VERSION//:/-}")
+
+  # TBC, maybe a timeout could help so it can run the other versions?
+  ${BASE_PROJECT}/spec/scripts/benchmarks.sh "${VERSION}" "${OUTPUT_NAME}"
+
+  # Gather error if any
+  if [ $? -gt 0 ] ; then
+    status=1
+  fi
+
+  # Then we ship the data using the helper
+  sendBenchmark "${ES_USER_SECRET}" "${ES_PASS_SECRET}" "${ES_URL_SECRET}" "${BASE_PROJECT}/spec/${OUTPUT_NAME}.bulk"
+done
+
+# Report status
+exit $status

data/.ci/scripts/install-build-system.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+set -euxo pipefail
+
+gem install rake yard rspec

data/.ci/snapshoty.yml

@@ -23,12 +23,11 @@ artifacts:
     # Files pattern to match
     files_pattern: 'elastic-apm-(?P<app_version>\d+\.\d+\.\d+)\.gem'
     # File layout on GCS bucket
-    output_pattern: '{project}/{jenkins_branch_name}/elastic-apm-ruby-{app_version}-{jenkins_git_commit_short}.gem'
+    output_pattern: '{project}/{github_branch_name}/elastic-apm-ruby-{app_version}-{github_sha_short}.gem'
     # List of metadata processors to use.
     metadata:
       # Define static custom metadata
       - name: 'custom'
         data:
           project: 'apm-agent-ruby'
-      # Add jenkins metadata
-      - name: 'jenkins'
+      - name: 'github_actions'

data/.ci/updatecli/updatecli.d/update-gherkin-specs.yml

@@ -0,0 +1,84 @@
+name: update-gherkin-specs
+pipelineid: update-gherkin-specs
+
+scms:
+  default:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+  apm:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.apm_repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+
+sources:
+  sha:
+    kind: file
+    spec:
+      file: 'https://github.com/{{ .github.owner }}/{{ .github.apm_repository }}/commit/{{ .github.branch }}.patch'
+      matchpattern: "^From\\s([0-9a-f]{40})\\s"
+    transformers:
+      - findsubmatch:
+          pattern: "[0-9a-f]{40}"
+  pull_request:
+    kind: shell
+    dependson:
+      - sha
+    spec:
+      command: gh api /repos/{{ .github.owner }}/{{ .github.apm_repository }}/commits/{{ source "sha" }}/pulls --jq '.[].html_url'
+      environments:
+        - name: GITHUB_TOKEN
+        - name: PATH
+  agents-gherkin-specs-tarball:
+    kind: shell
+    scmid: apm
+    dependson:
+      - sha
+    spec:
+      command: tar cvzf {{ requiredEnv "GITHUB_WORKSPACE" }}/gherkin-specs.tgz .
+      environments:
+        - name: PATH
+      workdir: "{{ .specs.apm_gherkin_path }}"
+
+actions:
+  pr:
+    kind: "github/pullrequest"
+    scmid: default
+    spec:
+      automerge: false
+      draft: false
+      labels:
+        - "automation"
+      description: |-
+        ### What
+        APM agent Gherkin specs automatic sync
+
+        ### Why
+        *Changeset*
+        * {{ source "pull_request" }}
+        * https://github.com/elastic/apm/commit/{{ source "sha" }}
+      title: '[Automation] Update Gherkin specs'
+
+targets:
+  agent-gherkin-specs:
+    name: APM agent gherkin specs {{ source "sha" }}
+    scmid: default
+    disablesourceinput: true
+    kind: shell
+    spec:
+      # git diff helps to print what it changed, If it is empty, then updatecli report a success with no changes applied.
+      # See https://www.updatecli.io/docs/plugins/resource/shell/#_shell_target
+      command: 'tar -xzf {{ requiredEnv "GITHUB_WORKSPACE" }}/gherkin-specs.tgz && git --no-pager diff'
+      workdir: "{{ .apm_agent.gherkin_specs_path }}"

data/.ci/updatecli/updatecli.d/update-json-specs.yml

@@ -0,0 +1,84 @@
+name: update-json-specs
+pipelineid: update-json-specs
+
+scms:
+  default:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+  apm:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.apm_repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+
+sources:
+  sha:
+    kind: file
+    spec:
+      file: 'https://github.com/{{ .github.owner }}/{{ .github.apm_repository }}/commit/{{ .github.branch }}.patch'
+      matchpattern: "^From\\s([0-9a-f]{40})\\s"
+    transformers:
+      - findsubmatch:
+          pattern: "[0-9a-f]{40}"
+  pull_request:
+    kind: shell
+    dependson:
+      - sha
+    spec:
+      command: gh api /repos/{{ .github.owner }}/{{ .github.apm_repository }}/commits/{{ source "sha" }}/pulls --jq '.[].html_url'
+      environments:
+        - name: GITHUB_TOKEN
+        - name: PATH
+  agents-json-specs-tarball:
+    kind: shell
+    scmid: apm
+    dependson:
+      - sha
+    spec:
+      command: tar cvzf {{ requiredEnv "GITHUB_WORKSPACE" }}/json-specs.tgz .
+      environments:
+        - name: PATH
+      workdir: "{{ .specs.apm_json_path }}"
+
+actions:
+  pr:
+    kind: "github/pullrequest"
+    scmid: default
+    spec:
+      automerge: false
+      draft: false
+      labels:
+        - "automation"
+      description: |-
+        ### What
+        APM agent specs automatic sync
+
+        ### Why
+        *Changeset*
+        * {{ source "pull_request" }}
+        * https://github.com/{{ .github.owner }}/{{ .github.apm_repository }}/commit/{{ source "sha" }}
+      title: '[Automation] Update JSON specs'
+
+targets:
+  agent-json-specs:
+    name: APM agent json specs {{ source "sha" }}
+    scmid: default
+    disablesourceinput: true
+    kind: shell
+    spec:
+      # git diff helps to print what it changed, If it is empty, then updatecli report a success with no changes applied.
+      # See https://www.updatecli.io/docs/plugins/resource/shell/#_shell_target
+      command: 'tar -xzf {{ requiredEnv "GITHUB_WORKSPACE" }}/json-specs.tgz && git --no-pager diff'
+      workdir: "{{ .apm_agent.json_specs_path }}"

data/.ci/updatecli/updatecli.d/update-specs.yml

@@ -0,0 +1,86 @@
+name: update-specs
+pipelineid: update-schema-specs
+
+scms:
+  default:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+
+  apm-data:
+    kind: github
+    spec:
+      user: '{{ requiredEnv "GIT_USER" }}'
+      email: '{{ requiredEnv "GIT_EMAIL" }}'
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.apm_data_repository }}"
+      token: '{{ requiredEnv "GITHUB_TOKEN" }}'
+      username: '{{ requiredEnv "GIT_USER" }}'
+      branch: "{{ .github.branch }}"
+
+sources:
+  sha:
+    kind: file
+    spec:
+      file: 'https://github.com/{{ .github.owner }}/{{ .github.apm_data_repository }}/commit/{{ .github.branch }}.patch'
+      matchpattern: "^From\\s([0-9a-f]{40})\\s"
+    transformers:
+      - findsubmatch:
+          pattern: "[0-9a-f]{40}"
+  pull_request:
+    kind: shell
+    dependson:
+      - sha
+    spec:
+      command: gh api /repos/{{ .github.owner }}/{{ .github.apm_data_repository }}/commits/{{ source "sha" }}/pulls --jq '.[].html_url'
+      environments:
+        - name: GITHUB_TOKEN
+        - name: PATH
+  agent-specs-tarball:
+    kind: shell
+    scmid: apm-data
+    dependson:
+      - sha
+    spec:
+      command: tar cvzf {{ requiredEnv "GITHUB_WORKSPACE" }}/json-schema.tgz .
+      environments:
+        - name: PATH
+      workdir: "{{ .specs.apm_data_path }}"
+
+actions:
+  pr:
+    kind: "github/pullrequest"
+    scmid: default
+    sourceid: sha
+    spec:
+      automerge: false
+      draft: false
+      labels:
+        - "automation"
+      description: |-
+        ### What
+        APM agent json server schema automatic sync
+
+        ### Why
+        *Changeset*
+        * {{ source "pull_request" }}
+        * https://github.com/{{ .github.owner }}/{{ .github.apm_data_repository }}/commit/{{ source "sha" }}
+      title: '[Automation] Update JSON server schema specs'
+
+targets:
+  agent-json-schema:
+    name: APM agent json server schema {{ source "sha" }}
+    scmid: default
+    disablesourceinput: true
+    kind: shell
+    spec:
+      # git diff helps to print what it changed, If it is empty, then updatecli report a success with no changes applied.
+      # See https://www.updatecli.io/docs/plugins/resource/shell/#_shell_target
+      command: 'tar -xzf {{ requiredEnv "GITHUB_WORKSPACE" }}/json-schema.tgz && git --no-pager diff'
+      workdir: "{{ .apm_agent.server_schema_specs_path  }}"

data/.ci/updatecli/values.yml

@@ -0,0 +1,14 @@
+github:
+  owner: "elastic"
+  repository: "apm-agent-ruby"
+  apm_repository: "apm"
+  apm_data_repository: "apm-data"
+  branch: "main"
+specs:
+  apm_data_path: "input/elasticapm/docs/spec/v2"
+  apm_json_path: "tests/agents/json-specs"
+  apm_gherkin_path: "tests/agents/gherkin-specs"
+apm_agent:
+  gherkin_specs_path: "features"
+  json_specs_path: "spec/fixtures"
+  server_schema_specs_path: "spec/fixtures"

data/.github/dependabot.yml

@@ -3,7 +3,9 @@ updates:
 - package-ecosystem: bundler
   directory: "/"
   schedule:
-    interval: daily
+    interval: "weekly"
+    day: "sunday"
+    time: "22:00"
   open-pull-requests-limit: 10
   ignore:
   - dependency-name: sucker_punch
@@ -14,3 +16,17 @@ updates:
     - 1.8.10
     - 1.8.8
     - 1.8.9
+
+  # GitHub actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    reviewers:
+      - "elastic/observablt-ci"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "22:00"
+    groups:
+      github-actions:
+        patterns:
+          - "*"

data/.github/workflows/README.md

@@ -0,0 +1,58 @@
+## CI/CD
+
+There are 5 main stages that run on GitHub actions:
+
+* Linting
+* Test
+* Test `main` versions
+* Package
+* Release
+
+There are some other stages that run for every push on the main branches:
+
+* [Microbenchmark](./microbenchmark.yml)
+* [Snapshoty](./snapshoty.yml)
+
+### Scenarios
+
+* Compatibility matrix runs on branches, tags and PRs basis.
+* Tests should be triggered on branch, tag and PR basis.
+* Commits that are only affecting the docs files should not trigger any test or similar stages that are not required.
+* Automated release in the CI gets triggered when a tag release is created.
+* **This is not the case yet**, but if Github secrets are required then Pull Requests from forked repositories won't run any build accessing those secrets. If needed, then create a feature branch.
+
+### Compatibility matrix
+
+Ruby agent supports compatibility to different ruby versions and frameworks, those are defined in:
+
+* [frameworks](../../.ci/.framework.yml) for all the PRs.
+* [frameworks](../../.ci/.main_framework.yml) for all the PRs using the `main` branches.
+* Ruby [versions](../../.ci/.ruby.yml) for all the `*nix` builds.
+* [Exclude list](../../.ci/.exclude.yml) for the above entries.
+
+### How to interact with the CI?
+
+#### On a PR basis
+
+Once a PR has been opened then there are two different ways you can trigger builds in the CI:
+
+1. Commit based
+1. UI based, any Elasticians can force a build through the GitHub UI
+
+#### Branches
+
+Every time there is a merge to main or any release branches the whole workflow will compile and test every entry in the compatibility matrix for Linux.
+
+### Release process
+
+This process has been fully automated and it gets triggered when a tag release has been created.
+The tag release follows the naming convention: `v.<major>.<minor>.<patch>`, where `<major>`, `<minor>` and `<patch>`.
+
+### OpenTelemetry
+
+There is a GitHub workflow in charge to populate what the workflow run in terms of jobs and steps. Those details can be seen in [here](https://ela.st/oblt-ci-cd-stats) (**NOTE**: only available for Elasticians).
+
+## Bump automation
+
+[updatecli](https://www.updatecli.io/) is the tool we use to automatically update the specs
+the [APM agents](./updatecli.yml) use.

data/.github/workflows/addToProject.yml

@@ -8,6 +8,9 @@ on:
 env:
   MY_GITHUB_TOKEN: ${{ secrets.APM_TECH_USER_TOKEN }}
 
+permissions:
+  contents: read
+
 jobs:
   assign_one_project:
     runs-on: ubuntu-latest

data/.github/workflows/ci-docs.yml

@@ -0,0 +1,20 @@
+---
+# This workflow sets the test / all status check to success in case it's a docs only PR and ci.yml is not triggered
+# https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/troubleshooting-required-status-checks#handling-skipped-but-required-checks
+name: ci # The name must be the same as in ci.yml
+
+on:
+  pull_request:
+    paths-ignore: # This expression needs to match the paths ignored on ci.yml.
+      - '**'
+      - '!**/*.md'
+      - '!**/*.asciidoc'
+
+permissions:
+  contents: read
+
+jobs:
+  all:
+    runs-on: ubuntu-latest
+    steps:
+      - run: 'echo "No build required"'