Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Proxmox integration (ECOINT-50) #2555

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .codecov.yml
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,10 @@ coverage:
target: 75
flags:
- portworx
Proxmox:
target: 75
flags:
- proxmox
Puma:
target: 75
flags:
Expand Down Expand Up @@ -522,6 +526,11 @@ flags:
paths:
- portworx/datadog_checks/portworx
- portworx/tests
proxmox:
carryforward: true
paths:
- proxmox/datadog_checks/proxmox
- proxmox/tests
puma:
carryforward: true
paths:
Expand Down
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,7 @@
/puma/ @plasticine
/purefa/ @chrroberts-pure [email protected] @DataDog/ecosystems-review
/purefb/ @chrroberts-pure [email protected] @DataDog/ecosystems-review
/proxmox/ @aureleoules
/qdrant/ @Anush008 [email protected]
/radarr/ @HadrienPatte
/rbltracker/ @DataDog/agent-integrations
Expand Down
19 changes: 19 additions & 0 deletions .github/workflows/test-all.yml
Original file line number Diff line number Diff line change
Expand Up @@ -847,6 +847,25 @@ jobs:
test-py3: ${{ inputs.test-py3 }}
setup-env-vars: "${{ inputs.setup-env-vars }}"
secrets: inherit
jf882f09:
uses: DataDog/integrations-core/.github/workflows/test-target.yml@master
with:
job-name: Proxmox
target: proxmox
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 }}
setup-env-vars: "${{ inputs.setup-env-vars }}"
secrets: inherit
j831ad4c:
uses: DataDog/integrations-core/.github/workflows/test-target.yml@master
with:
Expand Down
4 changes: 4 additions & 0 deletions proxmox/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# CHANGELOG - Proxmox

<!-- towncrier release notes start -->

aureleoules marked this conversation as resolved.
Show resolved Hide resolved
60 changes: 60 additions & 0 deletions proxmox/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Agent Check: Proxmox

## Overview

This check monitors [Proxmox][1] through the Datadog Agent.

Include a high level overview of what this integration does:
- What does your product do (in 1-2 sentences)?
- What value will customers get from this integration, and why is it valuable to them?
- What specific data will your integration monitor, and what's the value of that data?
aureleoules marked this conversation as resolved.
Show resolved Hide resolved

## 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 Proxmox check is included in the [Datadog Agent][2] package.
No additional installation is needed on your server.
aureleoules marked this conversation as resolved.
Show resolved Hide resolved

### Configuration

1. Edit the `proxmox.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your proxmox performance data. See the [sample proxmox.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 `proxmox` under the Checks section.

## Data Collected

### Metrics

See [metadata.csv][7] for a list of metrics provided by this integration.

### Events

The Proxmox integration does not include any events.

### Service Checks

The Proxmox integration does not include any service checks.

See [service_checks.json][8] for a list of service checks provided by this integration.
aureleoules marked this conversation as resolved.
Show resolved Hide resolved

## Troubleshooting

Need help? Contact [Datadog support][9].


[1]: **LINK_TO_INTEGRATION_SITE**
aureleoules marked this conversation as resolved.
Show resolved Hide resolved
[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/proxmox/datadog_checks/proxmox/data/conf.yaml.example
aureleoules marked this conversation as resolved.
Show resolved Hide resolved
[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/proxmox/metadata.csv
[8]: https://github.com/DataDog/integrations-core/blob/master/proxmox/assets/service_checks.json
[9]: https://docs.datadoghq.com/help/
27 changes: 27 additions & 0 deletions proxmox/assets/configuration/spec.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
name: Proxmox
files:
- name: proxmox.yaml
options:
- template: init_config
options:
- template: init_config/default
- template: instances
options:
- template: instances/default
- name: url
description: The URL of the Proxmox API.
value:
type: string
example: https://localhost:8006
- name: token_id
description: The token ID for the Proxmox API.
required: true
value:
type: string
example: <USER@REALM!TOKENID>
- name: token_secret
description: The token secret for the Proxmox API.
required: true
value:
type: string
example: <UUID>
Loading
Loading