Bindplane

The Bindplane Developer Hub

Welcome to the Bindplane developer hub. You'll find comprehensive guides and documentation to help you start working with Bindplane as quickly as possible, as well as support if you get stuck. Let's jump right in!

Cohesity Storage

Cohesity Hyper-converged Secondary Storage Monitoring

Data Collection Setup

Metrics are collected via REST API running on Cohesity Secondary storage arrays.

Network Requirements

Port: 443 (TCP) HTTPS to REST API running on Cohesity storage array

Least Privileged User

The least-privileged user must be assigned the pre-defined Viewer role in Cohesity management console.

Active Directory User

Active Directory users can be configured. This domain will be used in source configuration.

Example Provider configuration:

Active Directory Example

Supported Versions

Cohesity Storage Arrays: C2000 or C3000
Software: 4.0, 4.1, 5.0

Connection Parameters

NameRequired?Description
HostRequiredThe Cohesity Storage host to connect to.
PortThe port for communication to the Cohesity host.
DomainActive Directory Domain.
UsernameRequired
PasswordRequired
SSL ConfigurationThe SSL mode to use when connecting to the target. Can be configured to not use SSL (No SSL), use SSL but do not verify the target's certificate (No Verify), and use SSL and verify the target's certificate (Verify).
Minimum Event SeverityEvents with a severity level below this minimum will not be returned.
Max EventsThe maximum number of events to collect.
Event Cutoff TimeEvents before this time will not be collected.
Connection Timeout (seconds)The number of seconds to allow for connecting to the target.

Metrics

Cluster

NameDescription
Bonding ModeThe bonding mode when bonding NICs, such as '802_3ad' or 'BalanceAlb'. Supported NIC bonding modes such as '802_3ad' or 'BalanceAlb'.
Canceled RunsThe number of canceled protection job runs for this cluster.
Cloud and Local Data Read (Bytes)Provides the total amount of data read.
Cloud and Local Data Written (Bytes)Provides the total amount of data written.
Cloud and Local Physical Disk Capacity (Bytes)The physical disk capacity of the Cluster.
Cloud and Local Read Latency (Milliseconds)The read latency of the Cluster.
Cloud and Local Reads (Operations)Provides the Read latency for Read IOs.
Cloud and Local System Disk Capacity (Bytes)The system disk capacity of the Cluster.
Cloud and Local System Disk Usage (Bytes)The system disk usage of the Cluster.
Cloud and Local Total Physical Disk Usage (Bytes)The total physical disk usage of the Cluster.
Cloud and Local Write Latency (Milliseconds)The write latency of the Cluster.
Cloud and Local Writes (Operations)Provides the Write latency for Write IOs.
Created Time (Milliseconds)The Epoch time of cluster creation.
Current OperationThe current Cluster-level operation in progress. One of 'None', 'Upgrade', 'Destroy', 'Clean', or 'Remove Node'.
Data Reduction RatioThe ratio of logical bytes (not reduced by change-block tracking, compression and deduplication) to physical bytes (reduced by change-block tracking, compression and deduplication).
DNS Server IPsThe list of server IPs for the Cluster.
Domain NamesThe list of domain names in which the Cluster resides.
Encryption EnabledIs true if encryption is enabled for the Cluster.
Failed RunsThe number of failed protection job runs for this cluster.
IDThe unique id of the resource.
Jobs RunningThe current number of protection jobs running for this cluster.
Last Day Canceled RunsThe number of canceled protection job runs for this cluster in the past day.
Last Day Failed RunsThe number of failed protection job runs for this cluster in the past day.
Last Day Jobs RunningThe current number of protection jobs running for this cluster in the past day.
Last Day SLA ViolationsThe number of protection job runs with SLA Violations for this cluster in the past day.
Last Day Successful RunsThe number of Successful protection job runs for this cluster in the past day.
Last Day Total RunsThe total number of protection job runs for this cluster in the past day.
Local Data Read (Bytes)Provides the total amount of data read.
Local Data Written (Bytes)Provides the total amount of data written.
Local Physical Disk Capacity (Bytes)The physical disk capacity of the Cluster.
Local Read Latency (Milliseconds)The read latency of the Cluster.
Local Reads (Operations)Provides Read IOS.
Local System Disk Capacity (Bytes)The system disk capacity of the Cluster.
Local System Disk Usage (Bytes)The system disk usage of the Cluster.
Local Total Physical Disk Usage (Bytes)The total physical disk usage of the Cluster.
Local Write Latency (Milliseconds)The write latency of the Cluster.
Local Writes (Operations)Provides Write IOS.
Logical Data Read (Bytes)Provides the total amount of data read.
Logical Data Written (Bytes)Provides the total amount of data written.
Logical Read Latency (Milliseconds)Provides the Read latency for Read IOS.
Logical Reads (Operations)Provides Read IOs.
Logical Write Latency (Milliseconds)Provides the Write latency for Write IOS.
Logical Writes (Operations)Provides Write IOs.
ModelsThe hardware type for motherboard of the nodes that make up this Cohesity Cluster such as S2600WB for Ivy Bridge or S2600TP for Haswell.
NameThe name of the resource.
Node CountThe number of nodes connected to the Cluster.
SLA ViolationsThe number of protection job runs with SLA Violations for this cluster.
Software VersionThe software version for the Cluster.
Successful RunsThe number of Successful protection job runs for this cluster.
Total Logical Disk Usage (Bytes)The logical usage as computed by the Cohesity Cluster. The size of the data without reduction by change-block tracking, compression and deduplication.
Total RunsThe total number of protection job runs for this cluster.

External Target

NameDescription
Compression PolicySpecifies whether to send data to the Vault in a compressed format. 'Compression None' indicates that data is not compressed. 'Compression Low' indicates that data is compressed
Customer Managed KeysSpecifies whether to manage the encryption key manually or let the Cohesity Cluster manage it. If true, you must get the encryption key store it outside the Cluster, before disaster strikes such as the source local Cohesity Cluster being down. You can get the encryption key by downloading it using the Cohesity Dashboard or by calling the GET /public/vaults/encryptionKey/{id} operation.
Deduplication EnabledSpecifies whether to deduplicate data before sending it to the Vault.
DescriptionDescription about the External Target.
Encryption PolicySpecifies whether to send and store data in an encrypted format. 'Encryption None' indicates the data is not encrypted. 'Encryption Strong' indicates the data is encrypted.
Full Archive Interval (Days)Specifies the number days between full archives to the Vault. The current default is 90 days. This is only meaningful when incrementalArchivesEnabled is true and the Vault usage type is Archival
IDThe unique id of the resource.
Incremental ArchivesSpecifies whether to perform incremental archival when sending data to the Vault. If false, only full backups are performed. If true, incremental backups are performed between the full backups.
Key File Download Time (Microseconds)Specifies the time when the encryption key file was downloaded from the Cohesity Dashboard (Cohesity UI). An encryption key can only be downloaded once using the Cohesity Dashboard.
Key File Download UserSpecifies the user who downloaded the encryption key from the Cohesity Dashboard (Cohesity UI). This field is only populated if encryption is enabled for the Vault and customerManagingEncryptionKeys is true.
NameThe name of the resource.
TypeSpecifies the type of Vault. 'Nearline' indicates a Google Nearline Vault. 'Glacier' indicates an AWS Glacier Vault. 'S3' indicates an AWS S3 Vault. 'Azure Standard' indicates a Microsoft Azure Standard Vault. 'S3 Compatible' indicates an AWS S3 Compatible Vault. (See the online help for supported types.) 'QStar Tape' indicates a QStar Tape Vault. 'Google Standard' indicates a Google Standard Vault. 'GoogleDRA' indicates a Google DRA Vault. 'AWS GovCloud' indicates an AWS GovCloud Vault. 'NAS' indicates a NAS Vault. 'Azure Government' indicates a Microsoft Azure Government Cloud Vault.
Usage TypeSpecifies the usage type of the Vault. 'Archival' indicates the Vault provides archive storage for backup data. 'Cloud Spill' indicates the Vault provides additional storage for cold data.

Partition

NameDescription
HostnameSpecifies that hostname that resolves to one or more Virtual IP Addresses (VIPs).
IDThe unique id of the resource.
NameThe name of the resource.
Node IDsList of Node Ids that assigned to the Cluster Partition.
Virtual IPsList of Virtual IP Addresses (VIPs) that route network traffic to the Cluster Partition.
VLAN IPsList of VLAN IP Addresses that route network traffic within certain VLANs to the Cluster Partition.

Protection Job

NameDescription
Abort In Blackout PeriodIf true, the Cohesity Cluster aborts any currently executing Job Runs of this Protection Job when a blackout period specified for this Job starts, even if the Job Run started before the blackout period began.
Current Logical Backup Size (Bytes)Specifies the size of the source object (such as a VM) protected by this task on the primary storage after the snapshot is taken. The logical size of the data on the source if the data is fully hydrated or expanded and not reduced by change-block tracking, compression and deduplication.
Current Physical Backup Size (Bytes)Specifies the total amount of physical space used on the Cohesity Cluster to store the protected object after being reduced by change-block tracking, compression and deduplication. For example, if the logical backup size is 1GB, but only 1MB was used on the Cohesity Cluster to store it, this field be equal to 1MB.
Current Run Duration (Microseconds)The SLA Status of the current run of this protection job.
Current Run Error MessageThe status message of the current run of this protection job.
Current Run SLA ViolatedThe SLA Status of the current run of this protection job.
Current Run Start Time (Microseconds)The start time of the current run of this protection job.
Current Run StatusThe status of the current run of this protection job.
Current Size Read from Source (Bytes)Specifies the total amount of data read from the source (so far).
Current Source Size (Bytes)Specifies the size of the source object (such as a VM) protected by this task on the primary storage before the snapshot is taken. The logical size of the data on the source if the data is fully hydrated or expanded and not reduced by change-block tracking, compression and deduplication.
DescriptionDescription about the Protection Job.
EnvironmentThe environment type (such as VMware or SQL) of the Protection Policy. Supported environment types include 'View', 'SQL', 'VMware', 'Puppeteer', 'Physical' or 'Pure'. NOTE: 'Puppeteer' refers to Cohesity's Remote Adapter.
Full Protection Start HourThe time of day to start the Full Protection Schedule.
Full Protection Start MinuteThe time of day to start the Full Protection Schedule.
IDThe unique id of the resource.
Is ActiveIf the current state of the Protection Job is Active or Inactive.
Is DeletedIf the Protection Job was deleted but some Snapshots are still associated with this Job.
Is PausedIf the Protection Job is paused, which means that no new Job Runs are started but any existing Job Runs continue to execute.
Last Day Canceled RunsThe number of canceled runs for this protection job in the past day.
Last Day Failed RunsThe number of failed runs for this protection job in the past day.
Last Day Jobs RunningThe current number of jobs running for this protection job in the past day.
Last Day SLA ViolationsThe number of runs with SLA Violations for this protection job in the past day.
Last Day Successful RunsThe number of Successful runs for this protection job in the past day.
Last Day Total RunsThe total number of runs for this protection job in the past day.
Last Modified Time (Microseconds)The last time this Job was updated.
Latest Run Duration (Microseconds)The SLA Status of the latest run of this protection job.
Latest Run Error MessageThe status message of the latest run of this protection job.
Latest Run SLA ViolatedThe SLA Status of the latest run of this protection job.
Latest Run Start Time (Microseconds)The start time of the latest run of this protection job.
Latest Run StatusThe status of the latest run of this protection job.
NameThe name of the resource.
Parent Source IDThe id of the registered Protection Source that is the parent of the Objects that may be protected by this Job.
Policy IDThe unique id of the Protection Policy associated with the Protection Job.
PriorityThe priority of execution for a Protection Job.
Source IDsSpecifies the list of Object ids from the Protection Source to protect (or back up) by the Protection Job.
View Box IDThe View Box id where this Job writes data.
View NameFor a Remote Adapter 'Puppeteer' Job or a 'View' Job, this field specifies a View name that should be protected.
Virtual Machine Object IDsSpecifies the list of VMware Virtual Machine object ids to protect by the Protection Job.

Protection Policy

NameDescription
Continuous Backup Interval (Minutes)Defines the time interval in minutes when new Job Runs are started.
Daily Days to RunThe list of days of the week when to start Job Runs.
DescriptionDescription about the Protection Policy.
EnvironmentThe environment type (such as VMware or SQL) of the Protection Policy. Supported environment types include 'View', 'SQL', 'VMware', 'Puppeteer', 'Physical' or 'Pure'. NOTE: 'Puppeteer' refers to Cohesity's Remote Adapter.
IDThe unique id of the resource.
Last Modified Time (Milliseconds)The Epoch time when the Protection Policy was last modified.
Monthly Day CountThe day count in the month (such as 'Third') to start the Job Run.
Monthly Days to RunThe day of the week (such as 'Monday') to start the Job Run. Used with Monthly Day Count to define the day in the month to start the Job Run.
NameThe name of the resource.
PeriodicityHow often to start new Job Runs of a Protection Job.
RetriesThe number of times to retry capturing Snapshots before the Job Run fails.
Retry Interval (Minutes)The number of minutes before retrying a failed Protection Job.
Skip Interval (Minutes)The period of time before skipping the execution of new Job Runs if an existing queued Job Run of the same Protection Job has not started.
Snapshot Retention (Days)How many days to retain Snapshots on the Cohesity Cluster.

Protection Source

NameDescription
Database Instance NameThe database name of the SQL Protection Source.
Database NameThe database name of the SQL Protection Source.
Database Object TypeThe type of the managed Object in a SQL Protection Source.
Database Owner IDThe id of the container VM for the SQL Protection Source.
EnvironmentThe environment such as 'SQL' or 'VMware', where the Protection Source exists.
IDThe unique id of the resource.
Last Refresh Time (Microseconds)The Unix epoch time the Protection Source tree was most recently fetched and built.
NameThe name of the resource.
NAS NameThe name of the NAS Object.
NAS ProtocolThe protocol used by the NAS server.
NAS TypeThe type of a Protection Source Object in a generic NAS Source such as 'Group', or 'Host'.
NetApp NameThe name of the NetApp Object.
NetApp TypeThe type of managed NetApp Object in a NetApp Protection Source such as 'Cluster', 'Vserver' or 'Volume'.
NetApp UUIDThe globally unique ID of this Object assigned by the NetApp server.
Physical Agent IDThe physical server agent ID.
Physical Agent StatusThe status of the agent running on a physical source. 'Unknown' indicates the Agent is not known. No attempt to connect to the Agent has occurred. 'Unreachable' indicates the Agent is not reachable. 'Healthy' indicates the Agent is healthy. 'Degraded' indicates the Agent is running but in a degraded state.
Physical Agent UpgradabilityThe upgradability of the agent running on the physical server. 'Upgradable' indicates the Agent can be upgraded to the agent software version on the cluster. 'Current' indicates the Agent is running the latest version. 'Unknown' indicates the Agent's version is not known. 'NonUpgradableInvalidVersion' indicates the Agent's version is invalid. 'NonUpgradableAgentIsNewer' indicates the Agent's version is newer than the agent software version the cluster. 'NonUpgradableAgentIsOld' indicates the Agent's version is too old that does not support upgrades.
Physical Agent VersionThe version of the Agent software.
Physical Host TypeThe environment type for the host.
Physical IDThe unique Physical server ID.
Registration Time (Microseconds)The Epoch time when the Protection Source was registered.
Throttling EnabledWhether read operations from the datastores, which are part of the registered Protection Source, are throttled.
Throttling Thresholds for Existing Tasks (Milliseconds)If the latency of a datastore is above this value, existing backup tasks using the datastore are throttled.
Throttling Thresholds for New Tasks (Milliseconds)If the latency of a datastore is above this value, then new backup tasks using the datastore will not be started.
VMware Connection StateThe connection state of ESXi hosts ('Host System') or virtual machines ('Virtual Machine'). One of 'Connected', 'Disconnected', 'Inaccessible', 'Invalid', or 'Orphaned'.
VMware Host TypeThe host type for the 'VirtualMachine' Object.
VMware Object IDSpecifies the Managed Object Reference Item.
VMware Object UUIDThe type of managed Object in a VMware Protection Source.
VMware Source TypeThe type of managed Object in a VMware Protection Source.

Remote Cluster

NameDescription
Bandwidth Limit (Bytes per Second)The maximum allowed data transfer rate between the local Cluster and remote Clusters.
Encryption KeyThe encryption key used for encrypting the replication data from a local Cluster to a remote Cluster.
IDThe unique id of the resource.
IPsThe IP addresses of the Nodes on the remote Cluster to connect with. These IP addresses can also be VIPS. Specifying hostnames is not supported.
NameThe name of the resource.
Network Interface GroupThe group name of the network interfaces to use for communicating with the remote Cluster.
TimezoneA time zone for the specified time period. The time zone is defined in the following format: "Area/Location", for example: "America/New_York".
User NameThe Cohesity user name used to connect to the remote Cluster.
VLAN IDIs the id of the vlan to use when communicating with the remote cluster.

Restore Task

NameDescription
Bring Disks OnlineIf the volumes are brought online on the mount target after attaching the disks.
Completion Time (Microseconds)The end time of the Restore Task as a Unix epoch Timestamp.
Continue On ErrorIf the Restore Task should continue when some operations on some objects fail.
Datastore IDThe datastore where the object's files are recovered to.
Error CodeOperation response error code.
Error MessageDescription of the error.
IDThe unique id of the resource.
NameThe name of the resource.
Non-mount Volume Error MessageError that did not occur during the mount operation.
Powered OnThe power state of the cloned or recovered objects.
Protection Source IDsList of related Protection Sources.
Resource Pool IDThe overall status of the Restore Task. 'Ready To Schedule' indicates the Restore Task is waiting to be scheduled. 'Progress Monitor Created' indicates the progress monitor for the Restore Task has been created. 'Retrieved From Archive' indicates that the objects to restore have been retrieved from the specified archive. A Task will only ever transition to this state if a retrieval is necessary. 'Admitted' indicates the task has been admitted. After a task has been admitted, its status does not move back to 'Ready To Schedule' state even if it is rescheduled. 'In Progress' indicates that the Restore Task is in progress. 'Finishing Progress Monitor' indicates that the Restore Task is finishing its progress monitoring. 'Finished' indicates that the Restore Task has finished.
Start Time (Microseconds)The start time of the Restore Task as a Unix epoch Timestamp.
StatusThe overall status of the restore task. 'Ready To Schedule' indicates the task is waiting to be scheduled. 'Progress Monitor Created' indicates the progress monitor for the restore task has been created. 'Retrieved From Archive' indicates that the objects to restore have been retrieved from the specified archive. A task will only ever transition to this state if a retrieval is necessary. 'Admitted' indicates the task has been admitted. After a task has been admitted, its status does not move back to 'Ready To Schedule' state even if it is rescheduled. 'In Progress' indicates that the restore task is in progress. 'Finishing Progress Monitor' indicates that the restore task is finishing its progress monitoring. 'Finished' indicates that the Restore Task has finished. The status indicating success or failure is found in the error code that is stored with the restore task.
TypeThe type of Restore Task. 'kRecoverVMs' specifies a Restore Task that recovers VMs. 'kCloneVMs' specifies a Restore Task that clones VMs. 'kCloneView' specifies a Restore Task that clones a View. 'kMountVolumes' specifies a Restore Task that mounts volumes. 'kRestoreFiles' specifies a Restore Task that recovers files and folders.
UsernameThe Cohesity user who requested this Restore Task.

View

NameDescription
Alert Limit Quota (Bytes)If an alert should be triggered when the usage of this resource exceeds this quota limit.
Basic Mount PathThe NFS mount path of the View (without the hostname information). This path is used to support NFS mounting of the paths specified in the nfsExportPathList on Windows systems.
Creation Time (Milliseconds)The time of the View Box.
DescriptionDescription about the View.
Hard Limit Quota (Bytes)Optional quota limit on the usage allowed for this resource.
IDThe unique id of the resource.
Is InactiveIf this View is an inactive View that was created on this Remote Cluster to store the Snapshots created by replication. This inactive View cannot be NFS or SMB mounted.
Logical Usage (Bytes)The Logical Usage for the View.
NameThe name of the resource.
SMB Owner SIDThe security identifier of the owner of the SMB share.
Supported ProtocolsThe supported of the View Box.
View Box IDThe ID of the View Box where the View is stored.
View Box NameThe name of the View Box where the View is stored.

View Box

NameDescription
Alert Limit Quota (Bytes)If an alert should be triggered when the usage of this resource exceeds this quota limit.
Cloud and Local Data Read (Bytes)Provides the total amount of data read.
Cloud and Local Data Written (Bytes)Provides the total amount of data written.
Cloud and Local Physical Capacity (Bytes)The total physical capacity as computed by the Cohesity Cluster.
Cloud and Local Read Latency (Milliseconds)The Read latency for Read IOS.
Cloud and Local Reads (Operations)Provides the Read latency for Read IOs.
Cloud and Local System Capacity (Bytes)The total available capacity as computed by the Linux 'statfs' command.
Cloud and Local System Usage (Bytes)The usage, as computed by the Linux ?statfs? command, after the size of the data is reduced by change-block tracking, compression and deduplication.
Cloud and Local Total Physical Raw Usage (Bytes)The usage, as computed by the Cohesity Cluster, before the size of the data is reduced by change-block tracking, compression and deduplication.
Cloud and Local Total Physical Usage (Bytes)The total capacity, as computed by the Cohesity Cluster, after the size of the data has been reduced by change-block tracking, compression and deduplication.
Cloud and Local Write Latency (Milliseconds)The Write latency for Read IOS.
Cloud and Local Writes (Operations)Provides the Write latency for Write IOs.
Cluster Partition IDThe NFS mount path of the View (without the hostname information). This path is used to support NFS mounting of the paths specified in the nfsExportPathList on Windows systems.
Compression PolicyThe compression setting to be applied to a View Box. 'Compression None' indicates that data is not compressed. 'Compression Low' indicates that data is compressed.
Data Reduction RatioThe ratio of logical bytes (not reduced by change-block tracking, compression and deduplication) to physical bytes (reduced by change-block tracking, compression and deduplication).
Deduplication EnabledIf deduplication is enabled for the View Box.
Encryption PolicyThe encryption setting for the View Box. 'Encryption None' indicates the data is not encrypted. 'Encryption Strong' indicates the data is encrypted.
Hard Limit Quota (Bytes)Optional quota limit on the usage allowed for this resource.
IDThe unique id of the resource.
Inline CompressionIf compression should occur inline (as the data is being written).
Inline DeduplicationIf deduplication should occur inline (as the data is being written).
Local Data Read (Bytes)Provides the total amount of data read.
Local Data Written (Bytes)Provides the total amount of data written.
Local Physical Capacity (Bytes)The total physical capacity as computed by the Cohesity Cluster.
Local Read Latency (Milliseconds)The Read latency for Read IOS.
Local Reads (Operations)Provides Read IOS.
Local System Capacity (Bytes)The total available capacity as computed by the Linux 'statfs' command.
Local System Usage (Bytes)The usage, as computed by the Linux ?statfs? command, after the size of the data is reduced by change-block tracking, compression and deduplication.
Local Total Physical Raw Usage (Bytes)The usage, as computed by the Cohesity Cluster, before the size of the data is reduced by change-block tracking, compression and deduplication.
Local Total Physical Usage (Bytes)The total capacity, as computed by the Cohesity Cluster, after the size of the data has been reduced by change-block tracking, compression and deduplication.
Local Write Latency (Milliseconds)The Write latency for Read IOS.
Local Writes (Operations)Provides Write IOS.
Logical Data Read (Bytes)Provides the total amount of data read.
Logical Data Written (Bytes)Provides the total amount of data written.
Logical Read Latency (Milliseconds)Provides the Read latency for Read IOS.
Logical Reads (Operations)Provides Read IOs.
Logical Write Latency (Milliseconds)Provides the Write latency for Write IOS.
Logical Writes (Operations)Provides Write IOs.
NameThe name of the resource.
Removal StateThe current removal state of the View Box. "Don't Remove" means the state of object is functional and it is not being removed. 'Marked For Removal' means the object is being removed. 'Ok To Remove' means the object has been removed on the Cohesity Cluster and if the object is physical, it can be removed from the Cohesity Cluster.
Replica CountThe number of times a piece of data shall be replicated if the data is stored in replicated form.
Total Logical Disk Usage (Bytes)The logical usage as computed by the Cohesity Cluster. The size of the data without reduction by change-block tracking, compression and deduplication.

Updated 8 months ago

Cohesity Storage


Cohesity Hyper-converged Secondary Storage Monitoring

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.