Our next-gen architecture is built to help you make sense of your ever-growing data. Watch a 4-min demo video!

Back to All Docs

Service Retention Period gRPC API

Last Updated: May. 13, 2024

Adjust your service retention period with the Service Retention Period gRPC API.


Coralogix presents services in the Service Catalog based on their metrics. If we do not receive metrics for a service for 30 days, the service is removed from the Catalog. Similarly, if a database has no service interactions for 30 days, the database is removed from the Database Catalog.

This documentation details the Service Retention Period gRPC API, empowering you to modify the default 30-day period for removing services from your Service Catalog or databases from your Database Catalog in the absence of traffic.


To utilize the API, you must have the service-catalog:Update permission. This permission is automatically granted to the following roles: Data Admin, Platform Admin, Observability Lead, and Legacy Admin. Find out more here.


API endpoints

This reference document lists example requests and responses using gRPCurl. The following calls accept arguments as JSON in the request body and return results as JSON in the response body. A complete list of Management endpoints is available here.


Coralogix API uses API keys to authenticate requests. You can view and manage your API keys from the Data Flow tab in Coralogix. You need to use this API key in the Authorization request header to connect successfully.


grpcurl -H "Authorization: Bearer API_KEY_HERE"

Then, use one of our designated Management endpoints to structure your header.

d @ ng-api-grpc.coralogix.com:443

For the Service Retention Period API, the service name will be ReplaceRetentionPeriod.


The complete request header should look like this:

grpcurl -H "Authorization: Bearer <token>" -d @ <cx-gprc-endpoint> com.coralogixapis.service_catalog.v1.ApmSettingsService/ReplaceRetentionPeriod <<EOF
    "retention_period_in_days": <value>

Input the Management endpoint associated with your Coralogix domain.



The request payload should include the following structure:

    "retention_period_in_days": 30


    "retention_period_in_days": 30

Additional resources

DocumentationService Catalog
Database Monitoring
APM Onboarding Tutorial


Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at support@coralogix.com.

On this page