--- title: Appgate SDP description: Monitor the health and performance of Appgate SDP. breadcrumbs: Docs > Integrations > Appgate SDP --- # Appgate SDP Supported OS Integration version2.4.1 ## Overview{% #overview %} This check monitors [Appgate SDP](https://sdphelp.appgate.com/adminguide/v6.3/introduction.html) through the Datadog Agent. - Monitors the health and performance of Appgate SDP appliances, controllers, and gateways by collecting key metrics. - Provides visibility into resource utilization, active connections, session counts, and license usage to help ensure secure and efficient access management. - Enables proactive alerting and troubleshooting by tracking critical indicators such as CPU, memory, disk usage, and system events across distributed environments. **Minimum Agent version:** 7.59.0 ## Setup{% #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](https://docs.datadoghq.com/agent/kubernetes/integrations.md) for guidance on applying these instructions. ### Installation{% #installation %} The Appgate SDP check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server. ### Configuration{% #configuration %} 1. Edit the `appgate_sdp.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your Appgate SDP performance data. See the [sample appgate_sdp.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/appgate_sdp/datadog_checks/appgate_sdp/data/conf.yaml.example) for all available configuration options. 1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent). ### Validation{% #validation %} [Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `appgate_sdp` under the Checks section. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **appgate\_sdp.appliance.active\_connections**(gauge) | The current number of active connections.*Shown as connection* | | **appgate\_sdp.appliance.active\_connections.max**(gauge) | The maximum number of active connections.*Shown as connection* | | **appgate\_sdp.appliance.audit\_events.count**(count) | A count of the number of audit events.*Shown as event* | | **appgate\_sdp.appliance.audit\_logs.count**(count) | A count of the number of audit log transmissions. | | **appgate\_sdp.appliance.certificate\_days.remaining**(gauge) | The number of days remaining until certificate expiration. | | **appgate\_sdp.appliance.cpu.percent\_usage**(gauge) | The CPU usage of an appliance.*Shown as percent* | | **appgate\_sdp.appliance.disk**(gauge) | The disk usage of an appliance. | | **appgate\_sdp.appliance.disk.partition\_statistic**(gauge) | The disk partition usage of an appliance. | | **appgate\_sdp.appliance.dns.cache\_entries**(gauge) | The number of elements in the DNS cache, differentiated by cache type. | | **appgate\_sdp.appliance.dns.requests.count**(count) | The count of DNS requests made per zone, protocol and family.*Shown as request* | | **appgate\_sdp.appliance.dns.responses.count**(count) | The count of DNS responses made per zone, protocol and family.*Shown as response* | | **appgate\_sdp.appliance.function.sessions**(gauge) | The number of sessions for this appliance function. | | **appgate\_sdp.appliance.function.status**(gauge) | The status of the appliance function. | | **appgate\_sdp.appliance.function.suspended**(gauge) | The suspended status of an appliance function, differentiated by reason. | | **appgate\_sdp.appliance.image.size**(gauge) | The size of the appliance image partition in bytes.*Shown as byte* | | **appgate\_sdp.appliance.memory**(gauge) | The memory usage of the appliance in bytes.*Shown as byte* | | **appgate\_sdp.appliance.network\_interface.speed**(gauge) | The network interface speed in bits per second. | | **appgate\_sdp.appliance.network\_interface.statistic.count**(count) | The statistics on the network interface of the appliance. | | **appgate\_sdp.appliance.proxy.protocol\_messages.count**(count) | The number of proxy protocol messages processed.*Shown as message* | | **appgate\_sdp.appliance.snat**(gauge) | The number of UDP/TCP ports or ICMP types used for Source Network Address Translation (SNAT). | | **appgate\_sdp.appliance.spa.dropped\_packets.count**(count) | The number of dropped SPA packets.*Shown as packet* | | **appgate\_sdp.appliance.spa.packet\_authorization\_time**(gauge) | The SPA packet authorization time. | | **appgate\_sdp.appliance.spa.packets.count**(count) | The number of SPA (Single Packet Authorization) packets processed by the appliance.*Shown as packet* | | **appgate\_sdp.appliance.spa.replay\_attack\_cache\_entries.count**(count) | The number of entries in the SPA (Single Packet Authorization) replay attack cache. | | **appgate\_sdp.appliance.state\_size**(gauge) | The size of this appliance state partition in bytes.*Shown as byte* | | **appgate\_sdp.appliance.status**(gauge) | The status of an appliance in your network. | | **appgate\_sdp.appliance.volume\_number**(gauge) | The volume number of an appliance. | | **appgate\_sdp.controller.admin.authentication.count**(count) | The API call count for admin authentication. | | **appgate\_sdp.controller.admin.authorization.count**(count) | The API call count for admin authorization. | | **appgate\_sdp.controller.admin.evaluate\_all\_policies.count**(count) | The API call count for admin evaluatuation of all policies. | | **appgate\_sdp.controller.admin.mfa.count**(count) | The API call count for admin multi-factor authentication (MFA). | | **appgate\_sdp.controller.client.authentication.count**(count) | The API call count for client authentication. | | **appgate\_sdp.controller.client.authorization.count**(count) | The API call count for client authorization. | | **appgate\_sdp.controller.client.csr.count**(count) | The API call counts for client CSR (Certificate Signing Request) operations. | | **appgate\_sdp.controller.client.enter.password.count**(count) | The API call count for client enter password. | | **appgate\_sdp.controller.client.evaluate\_all\_policies.count**(count) | The API call count for client evaluatuation of all policies. | | **appgate\_sdp.controller.client.mfa.count**(count) | The API call count for client multi-factor authentication (MFA). | | **appgate\_sdp.controller.client.new\_ip\_allocation.count**(count) | The API call count for client new IP allocation. | | **appgate\_sdp.controller.client.risk\_engine\_response.count**(count) | The API call count for client risk engine response.*Shown as response* | | **appgate\_sdp.controller.client.sign\_in\_with\_mfa.count**(count) | The API call count for client sign in with multi-factor authentication (MFA). | | **appgate\_sdp.controller.database.conflicts**(gauge) | The number of database BDR (Bi-Directional Replication) conflicts for the controller. | | **appgate\_sdp.controller.database.node\_state**(gauge) | The state of a node within the BDR system. | | **appgate\_sdp.controller.database.raft\_state**(gauge) | The raft state of a node in the controller's BDR system. | | **appgate\_sdp.controller.database.replication**(gauge) | The connection status of nodes in the controller's BDR system. | | **appgate\_sdp.controller.database.replication.slot\_replay\_lag**(gauge) | The replication lag for a specific replication slot in the controller's BDR system in bytes.*Shown as byte* | | **appgate\_sdp.controller.database.size**(gauge) | The size of the PostgreSQL database used by the controller in bytes.*Shown as byte* | | **appgate\_sdp.controller.evaluate\_user\_claim\_script.count**(count) | The execution and performance of User Claim Scripts within the controller system. | | **appgate\_sdp.controller.ip\_pool**(gauge) | The usage of IP addresses from a specific IP pool. | | **appgate\_sdp.controller.license**(gauge) | The license entitlements for different types of users or features in your system. | | **appgate\_sdp.controller.license.days\_remaining**(gauge) | The number of days remaining until the next license expiration for the appliance.*Shown as day* | | **appgate\_sdp.controller.memory\_heap**(gauge) | The memory heap usage of the controller daemon.*Shown as byte* | | **appgate\_sdp.controller.policy\_evaluator**(gauge) | The cache size used by the controller policy evaluator.*Shown as byte* | | **appgate\_sdp.controller.threads**(gauge) | The number of threads currently running for the controller daemon on the appliance.*Shown as thread* | | **appgate\_sdp.gateway.azure\_resolver.cache.count**(count) | The count of various operations on the Azure Resolver cache, including cache hits, misses, insertions, and evictions. | | **appgate\_sdp.gateway.azure\_resolver.cache\_ttl**(gauge) | The time to live (TTL) of the Azure Resolver cache. | | **appgate\_sdp.gateway.dns\_forwarder.cache.count**(count) | The cache performance of the DNS forwarder, specifically the hits and misses in the DNS forwarder cache | | **appgate\_sdp.gateway.dns\_forwarder.domain.count**(count) | The number of DNS forwarder domain hits. | | **appgate\_sdp.gateway.dns\_forwarder.query.count**(count) | The number of DNS forwarder domain queries. | | **appgate\_sdp.gateway.event\_queue.period\_peak**(gauge) | The current peak size for gateway event queue. | | **appgate\_sdp.gateway.event\_queue.size**(gauge) | The size of the gateway event queue for the given measure. | | **appgate\_sdp.gateway.ha\_interface.count**(count) | The activity of network interfaces that are part of a high-availability setup. | | **appgate\_sdp.gateway.http.action.count**(count) | The count of HTTP actions processed by a gateway, specifically distinguishing between allowed and blocked HTTP actions. | | **appgate\_sdp.gateway.http.connection.count**(count) | The number of HTTP connections processed by the gateway, specifically distinguishing between accepted and handled connections. | | **appgate\_sdp.gateway.http.open\_connection**(gauge) | The number of open HTTP connections on the gateway, categorized by their current state (active or reading). | | **appgate\_sdp.gateway.http.requests.count**(count) | The total number of HTTP requests processed by the gateway.*Shown as request* | | **appgate\_sdp.gateway.illumio.resolver.cache.count**(count) | The metric count of the Illumio resolver cache. | | **appgate\_sdp.gateway.illumio.resolver.cache\_ttl**(gauge) | The time to live (TTL) for the Illumio resolver cache. | | **appgate\_sdp.gateway.illumio.resolver.label**(gauge) | The number of labels tracked by Illumio Resolver. | | **appgate\_sdp.gateway.name.resolver.cache.count**(count) | The usage of the resolver's cache. | | **appgate\_sdp.gateway.name.resolver.names\_missing\_resolver**(gauge) | The number of resource names configured on sites where the required resolver has not been configured. | | **appgate\_sdp.gateway.name.resolver.value**(gauge) | The number of resources discovered. | | **appgate\_sdp.gateway.policy.evaluator**(gauge) | The cache size of the gateway's policy evaluator.*Shown as byte* | | **appgate\_sdp.gateway.session.dropped\_signin.count**(count) | The number of gateway sessions that were dropped at sign-in.*Shown as session* | | **appgate\_sdp.gateway.session.event.count**(count) | The number of session events that have occurred on the gateway.*Shown as event* | | **appgate\_sdp.gateway.session.event\_timing**(gauge) | The timing for session-related events on the gateway. | | **appgate\_sdp.gateway.session.js\_exectime**(gauge) | The gateway session javascript execution time in milliseconds.*Shown as millisecond* | | **appgate\_sdp.gateway.sessiond.heap**(gauge) | The gate sessiond heap value.*Shown as byte* | | **appgate\_sdp.gateway.sessiond.thread\_count**(gauge) | The gateway sessiond thread count value.*Shown as thread* | | **appgate\_sdp.gateway.token\_size**(gauge) | The value for given a measure of token size.*Shown as byte* | | **appgate\_sdp.gateway.vpn.client\_metric**(gauge) | The measures, such as the uptime of all sites and DNS lookup failures, on the client | | **appgate\_sdp.gateway.vpn.memory\_usage**(gauge) | The total memory usage by the firewall engine in bytes | | **appgate\_sdp.gateway.vpn.resolved\_actions**(gauge) | The number of resolve solved actions | | **appgate\_sdp.gateway.vpn.rules**(gauge) | The number of firewall rules | | **appgate\_sdp.gateway.vpn.rules\_size**(gauge) | The size of the firewall rules in bytes for VPN sessions on a gateway.*Shown as byte* | | **appgate\_sdp.gateway.vpn.sessions**(gauge) | The number of VPN sessions on a particular gateway appliance.*Shown as session* | | **appgate\_sdp.portal.client**(gauge) | The portal client statistics on the appliance. | ### Events{% #events %} The Appgate SDP integration does not include any events. ### Service Checks{% #service-checks %} The Appgate SDP integration does not include any service checks. **appgate\_sdp.openmetrics.health** Returns `CRITICAL` if the Agent is unable to connect to the Appgate SDP OpenMetrics endpoint, otherwise returns `OK`. *Statuses: ok, critical* ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).