mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2024-12-18 14:40:26 +01:00
docs: add audit logs page for Cloud (#7193)
### Describe Your Changes
Please provide a brief description of the changes you made. Be as
specific as possible to help others understand the purpose and impact of
your modifications.
### Checklist
The following checks are **mandatory**:
- [x] My change adheres [VictoriaMetrics contributing
guidelines](https://docs.victoriametrics.com/contributing/).
---------
Signed-off-by: Artem Navoiev <tenmozes@gmail.com>
(cherry picked from commit 18dd4105be
)
This commit is contained in:
parent
2ba72aecf7
commit
33403bff16
@ -15,7 +15,7 @@ VictoriaMetrics Cloud provides programmatic access for managing cloud resources
|
|||||||
|
|
||||||
**Note: Access Tokens** are used for reading and writing data to deployments. They are separate from API Keys and should not be confused. API Keys are specifically for managing resources via the API, while Access Tokens handle data access for deployments.
|
**Note: Access Tokens** are used for reading and writing data to deployments. They are separate from API Keys and should not be confused. API Keys are specifically for managing resources via the API, while Access Tokens handle data access for deployments.
|
||||||
|
|
||||||
## API Swagger/OpenAPI Reference: [https://cloud.victoriametrics.com/api-docs](https://cloud.victoriametrics.com/api-docs)
|
## API Swagger/OpenAPI Reference: [https://console.victoriametrics.cloud/api-docs](https://console.victoriametrics.cloud/api-docs)
|
||||||
|
|
||||||
## API Key Properties:
|
## API Key Properties:
|
||||||
|
|
||||||
@ -23,23 +23,23 @@ VictoriaMetrics Cloud provides programmatic access for managing cloud resources
|
|||||||
* **Lifetime**: Key expiration date (no expiration is an option).
|
* **Lifetime**: Key expiration date (no expiration is an option).
|
||||||
* **Permissions**: Read-only or Read/Write access.
|
* **Permissions**: Read-only or Read/Write access.
|
||||||
* **Deployment Access**: Limit access to single, multiple, or all deployments. ***Note**: selecting all deployments in the list and the “All” option are not the same thing, the “All" option will also apply to future deployments that are created.*
|
* **Deployment Access**: Limit access to single, multiple, or all deployments. ***Note**: selecting all deployments in the list and the “All” option are not the same thing, the “All" option will also apply to future deployments that are created.*
|
||||||
* **Key Value**: Programmatically generated identifier. It's sensitive data used for Authentication. Any operation with API keys (including viewing/revealing Key Value), will be recorded in the Audit Log.
|
* **Key** or **Key Value**: Programmatically generated identifier. It's sensitive data used for Authentication. Any operation with API keys (including viewing/revealing Key Value), will be recorded in the [Audit Log](https://docs.victoriametrics.com/victoriametrics-cloud/audit-logs/).
|
||||||
|
|
||||||
![Create API Key](api-1.webp)
|
![Create API Key](api-1.webp)
|
||||||
|
|
||||||
## Authentication:
|
## Authentication:
|
||||||
|
|
||||||
* **API Key Creation**: Required for using the VictoriaMetrics Cloud API. You need to issue the key manually [here](https://cloud.victoriametrics.com/api_keys).
|
* **API Key Creation**: Required for using the VictoriaMetrics Cloud API. You need to issue the key manually [here](https://console.victoriametrics.cloud/api_keys).
|
||||||
* **HTTP Header**:
|
* **HTTP Header**:
|
||||||
* **Header Name**: `X-VM-Cloud-Access`
|
* **Header Name**: `X-VM-Cloud-Access`
|
||||||
* **Header Value**: `<Key-Value>`
|
* **Header Value**: `<Key-Value>`
|
||||||
|
|
||||||
## Alerting & Recording Rules API:
|
## Alerting & Recording Rules API:
|
||||||
|
|
||||||
* **List Files**: [API reference](https://cloud.victoriametrics.com/api-docs)
|
* **List Files**: [API reference](https://console.victoriametrics.cloud/api-docs)
|
||||||
* **View File**: [API reference](https://cloud.victoriametrics.com/api-docs)
|
* **View File**: [API reference](https://console.victoriametrics.cloud/api-docs)
|
||||||
* **Upload File**: [API reference](https://cloud.victoriametrics.com/api-docs)
|
* **Upload File**: [API reference](https://console.victoriametrics.cloud/api-docs)
|
||||||
* **Delete File**: [API reference](https://cloud.victoriametrics.com/api-docs)
|
* **Delete File**: [API reference](https://console.victoriametrics.cloud/api-docs)
|
||||||
|
|
||||||
For detailed setup instructions, check the [VictoriaMetrics Cloud - AlertManager Setup Guide](https://docs.victoriametrics.com/victoriametrics-cloud/alertmanager-setup-for-deployment/).
|
For detailed setup instructions, check the [VictoriaMetrics Cloud - AlertManager Setup Guide](https://docs.victoriametrics.com/victoriametrics-cloud/alertmanager-setup-for-deployment/).
|
||||||
|
|
||||||
|
36
docs/victoriametrics-cloud/audit-logs.md
Normal file
36
docs/victoriametrics-cloud/audit-logs.md
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
weight: 9
|
||||||
|
title: VictoriaMetrics Cloud Audit Logs
|
||||||
|
menu:
|
||||||
|
docs:
|
||||||
|
parent: "cloud"
|
||||||
|
weight: 8
|
||||||
|
name: Audit Logs
|
||||||
|
---
|
||||||
|
An [**audit log**](https://console.victoriametrics.cloud/audit) is a record of user and system activities within an organization. It captures details of who performed an action, what was done, and when it occurred. Audit logs are essential for security, compliance, and troubleshooting processes.
|
||||||
|
|
||||||
|
## Cloud Audit Log Scopes
|
||||||
|
|
||||||
|
VictoriaMetrics Cloud provides two scopes for audit logs:
|
||||||
|
|
||||||
|
1. **Organization-Level Audit Logs**
|
||||||
|
These logs record all activities at the organization level, such as user logins, token reveals, updates to payment information, and deployments being created or destroyed.
|
||||||
|
2. **Deployment-Level Audit Logs**
|
||||||
|
These logs record activities related to a specific deployment only, such as changes to deployment parameters, creating or deleting access tokens, and modifying alerting or recording rules.
|
||||||
|
|
||||||
|
## Example Log Entry
|
||||||
|
|
||||||
|
* **Time**: 2024-10-0515:40 UTC
|
||||||
|
* **Email**: cloud-admin@victoriametrics.com
|
||||||
|
* **Action**: cluster updated: production-platform, changed properties: vmstorage settings changed: disk size changed from 50.0TB to 80.0TB,
|
||||||
|
|
||||||
|
## Filtering
|
||||||
|
|
||||||
|
The audit log page offers filtering options, allowing you to filter logs by time range, actor, or perform a full-text search by action.
|
||||||
|
|
||||||
|
## Export to CSV
|
||||||
|
|
||||||
|
The Export to CSV button on the audit log page allows you to export the entire audit log as a CSV file.
|
||||||
|
|
||||||
|
Filtering does not affect the export; you will always receive the entire audit log in the exported file.
|
||||||
|
|
@ -10,10 +10,10 @@ menu:
|
|||||||
## Basic Support
|
## Basic Support
|
||||||
All offerings include basic support, where we maintain the health of your deployments, perform system upgrades, and proactively contact customers if issues arise.
|
All offerings include basic support, where we maintain the health of your deployments, perform system upgrades, and proactively contact customers if issues arise.
|
||||||
|
|
||||||
All changes are logged and visible in the [Audit log](https://cloud.victoriametrics.com/audit).
|
All changes are logged and visible in the [Audit log](https://console.victoriametrics.cloud/audit ). For more details, check the [documentation](https://docs.victoriametrics.com/victoriametrics-cloud/audit-logs/)
|
||||||
|
|
||||||
## How to Reach Support
|
## How to Reach Support
|
||||||
To contact support, use the [Contact Support](https://cloud.victoriametrics.com/contact_support) button in the Cloud UI.
|
To contact support, use the [Contact Support](https://console.victoriametrics.cloud/contact_support) button in the Cloud UI.
|
||||||
|
|
||||||
We categorize support requests into three types:
|
We categorize support requests into three types:
|
||||||
- Issues
|
- Issues
|
||||||
|
Loading…
Reference in New Issue
Block a user