ARLAS Persistence API Overview

IMPORTANT

Three types of storage are available in this server: - File system storage - All SQL SGBD compliant with hibernate, we use a non configurable unique table user_data in a dedicated configurable database. ARLAS Persistence WILL NOT CREATE the table for you, think to create table before running the server. WARNING if you want to use this storage, make sure you have the environment variable ARLAS_PERSISTENCE_ENGINE set to "hibernate" with the double quote. - Google Cloud Firestore : think to set GOOGLE_APPLICATION_CREDENTIALS as environement variable.

The ARLAS Persistence offers 3 APIs:

• a management API for Data, meaning adding,deleting,updating an entry in storage.
• an API for monitoring the server health and performances
• endpoints for testing the write API and the status API with swagger

Monitoring

The monitoring API provides some information about the health and the performances of the ARLAS Persistence that can be of interest:

URL	Description
http://.../admin/metrics?pretty=true	Metrics about the performances of the ARLAS Persistence.
http://.../admin/ping	Returns pong
http://.../admin/threads	List of running threads
http://.../admin/healthcheck?pretty=true	Whether the service is healthy or not

Swagger

URL	Description
http://.../arlas_persistence/swagger	The web application for testing the API
http://.../arlas_persistence/swagger.yaml	The swagger definition of the collections/exploration API with YAML format
http://.../arlas_persistence/swagger.json	The swagger definition of the collections/exploration API with JSON format