Silverstripe CMS

Supported OS Linux Windows Mac OS

Integration version1.0.0

Silverstripe CMS - Overview

Overview

Silverstripe CMS is an open-source platform for creating and managing websites and web applications. It offers an intuitive admin panel for easy content editing and customization without coding. Its flexible framework makes it ideal for both simple sites and complex projects.

The SilverStripe CMS integration collects metrics for files, pages, and failed login attempts, and sends them to Datadog for analysis and monitoring.

Setup

Installation

The Silverstripe CMS integration is included in the Datadog Agent package. No additional installation is necessary.

Get Database credentials from Silverstripe CMS

Parameter	Description
Database Type	The type of database server, either MySQL or PostgreSQL.
Database Name	The name of the configured database.
Database Username	The username used to connect to the database.
Database Password	The password associated with the database user.
Database Server IP	The IP address of the database server.
Database Port	The Port Number of the database server.

Connect your Silverstripe CMS account to agent

Copy the conf.yaml.example file.

cp /etc/datadog-agent/conf.d/silverstripe_cms.d/conf.yaml.example /etc/datadog-agent/conf.d/silverstripe_cms.d/conf.yaml

Add this configuration block to your silverstripe_cms.d/conf.yaml file to start collecting your metrics.

See the sample silverstripe_cms.d/conf.yaml for available configuration options.

If you need to configure multiple instances of Silverstripe CMS in the conf.yaml file, reference the following example:

  init_config:
  instances:
    - SILVERSTRIPE_DATABASE_TYPE: PostgreSQL
      SILVERSTRIPE_DATABASE_NAME: <DATABASE_NAME_1>
      SILVERSTRIPE_DATABASE_SERVER_IP: <IPV4>
      SILVERSTRIPE_DATABASE_PORT: <PORT_NUMBER>
      SILVERSTRIPE_DATABASE_USERNAME: <USERNAME_1>
      SILVERSTRIPE_DATABASE_PASSWORD: <PASSWORD_1>
      min_collection_interval: 300
    - SILVERSTRIPE_DATABASE_TYPE: MySQL
      SILVERSTRIPE_DATABASE_NAME: <DATABASE_NAME_2>
      SILVERSTRIPE_DATABASE_SERVER_IP: <IPV4>
      SILVERSTRIPE_DATABASE_PORT: <PORT_NUMBER>
      SILVERSTRIPE_DATABASE_USERNAME: <USERNAME_2>
      SILVERSTRIPE_DATABASE_PASSWORD: <PASSWORD_2>
      min_collection_interval: 300

Restart the Agent.

Validation

Run the Agent’s status subcommand and look for silverstripe_cms under the Checks section.
Alternatively, use the following command to obtain detailed information about the integration:
```
sudo datadog-agent check silverstripe_cms
```
The check returns OK if all the configurations are correct and the Agent is able to communicate with Silverstripe CMS.

Data Collected

Log

The Silverstripe CMS integration does not include any logs.

Metrics

The Silverstripe CMS integration collects and forwards the following metrics to Datadog.

silverstripe_cms.failed_login_count (gauge)	Number of Failed logins
silverstripe_cms.files.count (gauge)	Number of Files/images available in CMS
silverstripe_cms.files.public_count (gauge)	Number of files/images that can be accessed by anyone
silverstripe_cms.files_live.count (gauge)	Number of files currently published
silverstripe_cms.files_live.public_count (gauge)	Number of files published and accessible by anyone
silverstripe_cms.pages.broken_content (gauge)	Number of pages that have broken content(link/file)
silverstripe_cms.pages.broken_file_count (gauge)	Number of pages that have broken files
silverstripe_cms.pages.broken_link_count (gauge)	Number of pages that have broken links
silverstripe_cms.pages.count (gauge)	Number of pages available in CMS
silverstripe_cms.pages_live.broken_content (gauge)	Number of published pages that have broken content(link/file)
silverstripe_cms.pages_live.broken_file_count (gauge)	Number of published pages with broken files
silverstripe_cms.pages_live.broken_link_count (gauge)	Number of published pages with broken links
silverstripe_cms.pages_live.count (gauge)	Number of published pages
silverstripe_cms.pages_live.deleted_count (gauge)	Number of pages/versions deleted

Service Checks

The Silverstripe CMS includes service checks that are listed in the service_checks.json file.

Events

Silverstripe.CMS.silverstripe_cms_authentication triggered for authentication of the provided parameters.

Uninstallation

For integrations running on the Agent:

Fully remove the integration using the datadog-agent integration remove command. For more information, see Integration management.

Support

For further assistance, contact Datadog support.