Health

SERVER

Platform

Version

The Health service is designed to allow you to both validate and monitor that your Appwrite instance and all of its internal components are up and responsive.

Base URL

https://cloud.appwrite.io/v1

Get HTTP

Check the Appwrite HTTP server is up and responsive.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.get()

Get antivirus

Check the Appwrite Antivirus server is up and connection is successful.

Response
- 200 application/json
  
  Health Antivirus

Endpoint

GET /health/anti-virus

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getAntivirus()

Get cache

Check the Appwrite in-memory cache servers are up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/cache

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getCache()

Get the SSL certificate for a domain

Request
- domain string
  
  string
Response
- 200 application/json
  
  Health Certificate

Endpoint

GET /health/certificate

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getCertificate(
    domain = "" // optional
)

Get DB

Check the Appwrite database servers are up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/db

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getDB()

Get pubsub

Check the Appwrite pub-sub servers are up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/pubsub

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getPubSub()

Get queue

Check the Appwrite queue messaging servers are up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/queue

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueue()

Get builds queue

Get the number of builds that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/builds

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueBuilds(
    threshold = 0 // optional
)

Get certificates queue

Get the number of certificates that are waiting to be issued against Letsencrypt in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/certificates

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueCertificates(
    threshold = 0 // optional
)

Get databases queue

Get the number of database changes that are waiting to be processed in the Appwrite internal queue server.

Request
- name string
  
  Queue name for which to check the queue size
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/databases

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueDatabases(
    name = "<NAME>", // optional
    threshold = 0 // optional
)

Get deletes queue

Get the number of background destructive changes that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/deletes

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueDeletes(
    threshold = 0 // optional
)

Get number of failed queue jobs

Returns the amount of failed jobs in a given queue.

Request
- name string
  required
  
  The name of the queue
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/failed/{name}

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health
import io.appwrite.enums.Name

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getFailedJobs(
    name =  .V1_DATABASE,
    threshold = 0 // optional
)

Get functions queue

Get the number of function executions that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/functions

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueFunctions(
    threshold = 0 // optional
)

Get logs queue

Get the number of logs that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/logs

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueLogs(
    threshold = 0 // optional
)

Get mails queue

Get the number of mails that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/mails

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueMails(
    threshold = 0 // optional
)

Get messaging queue

Get the number of messages that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/messaging

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueMessaging(
    threshold = 0 // optional
)

Get migrations queue

Get the number of migrations that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/migrations

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueMigrations(
    threshold = 0 // optional
)

Get usage queue

Get the number of metrics that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/usage

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueUsage(
    threshold = 0 // optional
)

Get usage dump queue

Get the number of projects containing metrics that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/usage-dump

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueUsageDump(
    threshold = 0 // optional
)

Get webhooks queue

Get the number of webhooks that are waiting to be processed in the Appwrite internal queue server.

Request
- threshold integer
  
  Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.
Response
- 200 application/json
  
  Health Queue

Endpoint

GET /health/queue/webhooks

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getQueueWebhooks(
    threshold = 0 // optional
)

Get storage

Check the Appwrite storage device is up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/storage

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getStorage()

Get local storage

Check the Appwrite local storage device is up and connection is successful.

Response
- 200 application/json
  
  Health Status

Endpoint

GET /health/storage/local

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getStorageLocal()

Check the Appwrite server time is synced with Google remote NTP server. We use this technology to smoothly handle leap seconds with no disruptive events. The Network Time Protocol (NTP) is used by hundreds of millions of computers and devices to synchronize their clocks over the Internet. If your computer sets its own clock, it likely uses NTP.

Response
- 200 application/json
  
  Health Time

Endpoint

GET /health/time

Kotlin

import io.appwrite.Client
import io.appwrite.coroutines.CoroutineCallback
import io.appwrite.services.Health

val client = Client()
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("5df5acd0d48c2") // Your project ID
    .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key

val health = Health(client)

val response = health.getTime()

Health

Get HTTP

Get antivirus

Get cache

Get the SSL certificate for a domain

Get DB

Get pubsub

Get queue

Get builds queue

Get certificates queue

Get databases queue

Get deletes queue

Get number of failed queue jobs

Get functions queue

Get logs queue

Get mails queue

Get messaging queue

Get migrations queue

Get usage queue

Get usage dump queue

Get webhooks queue

Get storage

Get local storage

Get time

Recommended