Configuring Services

Without explicit configuration all monitored requests are assigned to the service app, which is also the default service being shown in the project overview inside Tideways and in the weekly report e-mail and history.

Until September 2022 the default service name was web.

To start collecting data with a different service name, you can use one of three different configuration mechanisms to set different services names.

The service name can contain alphanumeric characters, a dash or underscore. It must not contain spaces or other non alphanumeric characters or it will be rejected.

Services are created automatically in Tideways backend as soon as they collecet data.

ini-Configuration

Inside your tideways.ini, php.ini or webserver ini directives you can set the variable:

tideways.service=myservice1

Environment Variable

In environment variables passed to PHP you can set:

TIDEWAYS_SERVICE=myservice1

Configuration in Code

Programmatically in your PHP code you can set the service at runtime:

<?php

if (class_exists('Tideways\Profiler')) {
    \Tideways\Profiler::setServiceName('myservice1');
}

Of if you are starting Tideways from within your PHP code you can set it as well:

<?php

if (class_exists('Tideways\Profiler')) {
    \Tideways\Profiler::start(array('api_key' => 'XYZ', 'service' => 'myservice1'));
}

Default Service

Every project has a default service that is the first service shown when viewing the project. Absent further configuration only the default service is included in the weekly report.

The first service reporting data to a Tideways project is automatically selected to be the default service. If none is configured this is app.

You can change the default service and weekly report inclusion in the Project Settings.

Service Limits

It depends on your plan and project license how many services you can use with a project. You can look up the limit on the "Project Settings ⇒ Services" screen and on the pricing page.

When your project reports more than the allowed limit of services, then the excess services data will be discarded and the service is marked as inactive on the "Services" settings screen. This can also happen if you downgrade a project from a higher license to a lower license.

Still need help? Email [email protected]