Add the Ray integration

Author: FlorentClarret

.codecov.yml

@@ -454,6 +454,10 @@ coverage:
         target: 75
         flags:
         - rabbitmq
+      Ray:
+        target: 75
+        flags:
+        - ray
       Redis:
         target: 75
         flags:
@@ -1215,6 +1219,11 @@ flags:
     paths:
     - rabbitmq/datadog_checks/rabbitmq
     - rabbitmq/tests
+  ray:
+    carryforward: true
+    paths:
+    - ray/datadog_checks/ray
+    - ray/tests
   redisdb:
     carryforward: true
     paths:

.github/workflows/config/labeler.yml

@@ -345,6 +345,8 @@ integration/pulsar:
 - pulsar/**/*
 integration/rabbitmq:
 - rabbitmq/**/*
+integration/ray:
+- ray/**/*
 integration/redisdb:
 - redisdb/**/*
 integration/rethinkdb:

.github/workflows/test-all.yml

@@ -2576,6 +2576,25 @@ jobs:
       test-py3: ${{ inputs.test-py3 }}
       minimum-base-package: ${{ inputs.minimum-base-package }}
     secrets: inherit
+  jcc172a7:
+    uses: ./.github/workflows/test-target.yml
+    with:
+      job-name: Ray
+      target: ray
+      platform: linux
+      runner: '["ubuntu-22.04"]'
+      repo: "${{ inputs.repo }}"
+      python-version: "${{ inputs.python-version }}"
+      standard: ${{ inputs.standard }}
+      latest: ${{ inputs.latest }}
+      agent-image: "${{ inputs.agent-image }}"
+      agent-image-py2: "${{ inputs.agent-image-py2 }}"
+      agent-image-windows: "${{ inputs.agent-image-windows }}"
+      agent-image-windows-py2: "${{ inputs.agent-image-windows-py2 }}"
+      test-py2: ${{ inputs.test-py2 }}
+      test-py3: ${{ inputs.test-py3 }}
+      minimum-base-package: ${{ inputs.minimum-base-package }}
+    secrets: inherit
   ja7f6415:
     uses: ./.github/workflows/test-target.yml
     with:

ray/CHANGELOG.md

@@ -0,0 +1,7 @@
+# CHANGELOG - Ray
+
+## 1.0.0 / 2023-08-01
+
+***Added***:
+
+* Initial Release ([#15441](https://github.com/DataDog/integrations-core/pull/15441))

ray/README.md

@@ -0,0 +1,55 @@
+# Agent Check: Ray
+
+## Overview
+
+This check monitors [Ray][1] through the Datadog Agent.
+
+## Setup
+
+Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates][3] for guidance on applying these instructions.
+
+### Installation
+
+The Ray check is included in the [Datadog Agent][2] package.
+No additional installation is needed on your server.
+
+### Configuration
+
+1. Edit the `ray.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your ray performance data. See the [sample ray.d/conf.yaml][4] for all available configuration options.
+
+2. [Restart the Agent][5].
+
+### Validation
+
+[Run the Agent's status subcommand][6] and look for `ray` under the Checks section.
+
+## Data Collected
+
+### Metrics
+
+See [metadata.csv][7] for a list of metrics provided by this integration.
+
+### Events
+
+The Ray integration does not include any events.
+
+### Service Checks
+
+The Ray integration does not include any service checks.
+
+See [service_checks.json][8] for a list of service checks provided by this integration.
+
+## Troubleshooting
+
+Need help? Contact [Datadog support][9].
+
+
+[1]: **LINK_TO_INTEGRATION_SITE**
+[2]: https://app.datadoghq.com/account/settings/agent/latest
+[3]: https://docs.datadoghq.com/agent/kubernetes/integrations/
+[4]: https://github.com/DataDog/integrations-core/blob/master/ray/datadog_checks/ray/data/conf.yaml.example
+[5]: https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent
+[6]: https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information
+[7]: https://github.com/DataDog/integrations-core/blob/master/ray/metadata.csv
+[8]: https://github.com/DataDog/integrations-core/blob/master/ray/assets/service_checks.json
+[9]: https://docs.datadoghq.com/help/

ray/assets/configuration/spec.yaml

@@ -0,0 +1,10 @@
+name: Ray
+files:
+- name: ray.yaml
+  options:
+  - template: init_config
+    options:
+    - template: init_config/openmetrics
+  - template: instances
+    options:
+    - template: instances/openmetrics

ray/assets/service_checks.json

@@ -0,0 +1,17 @@
+[
+    {
+        "agent_version": "7.49.0",
+        "integration": "Ray",
+        "check": "ray.openmetrics.health",
+        "statuses": [
+            "ok",
+            "critical"
+        ],
+        "groups": [
+            "host",
+            "endpoint"
+        ],
+        "name": "Ray openmetrics endpoint up",
+        "description": "Returns `CRITICAL` if the check cannot access the openmetrics metrics endpoint of Ray."
+    }
+]

ray/datadog_checks/__init__.py

@@ -0,0 +1,4 @@
+# (C) Datadog, Inc. 2023-present
+# All rights reserved
+# Licensed under a 3-clause BSD style license (see LICENSE)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # type: ignore

ray/datadog_checks/ray/__about__.py

@@ -0,0 +1,4 @@
+# (C) Datadog, Inc. 2023-present
+# All rights reserved
+# Licensed under a 3-clause BSD style license (see LICENSE)
+__version__ = '0.0.1'

ray/datadog_checks/ray/__init__.py

@@ -0,0 +1,7 @@
+# (C) Datadog, Inc. 2023-present
+# All rights reserved
+# Licensed under a 3-clause BSD style license (see LICENSE)
+from .__about__ import __version__
+from .check import RayCheck
+
+__all__ = ['__version__', 'RayCheck']