feat: add ping() to audit adapters for connectivity checks

src/Audit/Adapter.php

@@ -239,4 +239,13 @@ abstract public function find(array $queries = []): array;
      * @throws \Exception
      */
     abstract public function count(array $queries = [], ?int $max = null): int;
+
+    /**
+     * Ping the adapter to check connectivity.
+     *
+     * Returns false on any connectivity failure rather than throwing.
+     *
+     * @return bool True when the backing store is reachable, false otherwise.
+     */
+    abstract public function ping(): bool;
 }

src/Audit/Adapter/ClickHouse.php

@@ -113,6 +113,29 @@ public function getName(): string
         return 'ClickHouse';
     }
 
+    /**
+     * Ping ClickHouse to check connectivity.
+     *
+     * Uses ClickHouse's dedicated /ping endpoint, which bypasses the query
+     * pipeline, requires no database context, and is not recorded in query
+     * logs. Returns false on any connectivity failure rather than throwing.
+     *
+     * @return bool True when ClickHouse is reachable, false otherwise.
+     */
+    public function ping(): bool
+    {
+        $scheme = $this->secure ? 'https' : 'http';
+        $url = "{$scheme}://{$this->host}:{$this->port}/ping";
+
+        try {
+            $response = $this->client->fetch(url: $url, method: Client::METHOD_GET);
+        } catch (\Throwable) {
+            return false;
+        }
+
+        return $response->getStatusCode() === 200;
+    }
+
     /**
      * Validate host parameter.
      *

src/Audit/Adapter/Database.php

@@ -34,6 +34,22 @@ public function getName(): string
         return 'Database';
     }
 
+    /**
+     * Ping the database to check connectivity.
+     *
+     * Returns false on any connectivity failure rather than throwing.
+     *
+     * @return bool True when the database is reachable, false otherwise.
+     */
+    public function ping(): bool
+    {
+        try {
+            return $this->db->ping();
+        } catch (\Throwable) {
+            return false;
+        }
+    }
+
     /**
      * Setup database structure.
      *

src/Audit/Audit.php

@@ -287,4 +287,16 @@ public function count(array $queries = [], ?int $max = null): int
     {
         return $this->adapter->count($queries, $max);
     }
+
+    /**
+     * Ping the adapter to check connectivity.
+     *
+     * Returns false on any connectivity failure rather than throwing.
+     *
+     * @return bool True when the backing store is reachable, false otherwise.
+     */
+    public function ping(): bool
+    {
+        return $this->adapter->ping();
+    }
 }

tests/Audit/AuditBase.php

@@ -62,6 +62,11 @@ public function createLogs(): void
         $this->assertInstanceOf('Utopia\\Audit\\Log', $this->audit->log(null, 'insert', 'user/null', $userAgent, $ip, $dataWithAttributes));
     }
 
+    public function testPing(): void
+    {
+        $this->assertTrue($this->audit->ping());
+    }
+
     public function testGetLogsByUser(): void
     {
         $logs = $this->audit->getLogsByUser('userId');