# Quickstart

To start using Clete in your organisation, you need to sign up with a Github account:

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2FLokbF8qkXkfrXxqYzotB%2FGithub_sign_up.jpeg?alt=media&#x26;token=d59fbb05-1403-4024-b556-a2e629a35e16" alt=""><figcaption></figcaption></figure>

Once, you are authenticated, you can setup an organisation which will require the organisation name and product choice

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2F4RIl3y6Ljyhkvi2bmQSn%2FWhatsApp%20Image%202025-01-31%20at%2019.01.02.jpeg?alt=media&#x26;token=3d85b375-7b32-4938-ba65-e1958411bb39" alt=""><figcaption><p>Organiosation setup view</p></figcaption></figure>

Once the organisation setup is done, you can provide details about the service you'd like Clete to monitor and also provide additional description about that service (known as context hereafter)

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2FrTyaLFxzmo8YV71DC4tx%2Fservice_context_setup_1.jpeg?alt=media&#x26;token=0c13b81f-0e42-43a1-84d5-42f6ec3df740" alt=""><figcaption><p>Service Description</p></figcaption></figure>

Once you click on "submit configuration", you will be redirected to another form which collects more information on the platform

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2Fbrtps13KtSG12r1Bi0o0%2Fthe_main_platform.jpeg?alt=media&#x26;token=33e903b6-ec5e-405e-b27c-89fff14d57b8" alt=""><figcaption></figcaption></figure>

Under platform type, you specify if the platform your service is hosted on which could be Data, Compute, Monitoring etc and the environment could be either development, staging, and production

Next, you specify the dependencies and on-call contacts.

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2FkHucHZCmjjRdZZT5t9u7%2Fplatform_images.jpeg?alt=media&#x26;token=383ba7c6-f6c2-417b-9907-71fe854bdf6d" alt=""><figcaption></figcaption></figure>

Once you are done with service configuration, you can connect to your a virtual machine by clicking the "observability machine" button. The VM takes a few minutes to setup as it installs Clete and key dependencies.

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2FvM6BCeB1SwIgzeZSg1ET%2Fterminal_browser.jpeg?alt=media&#x26;token=7d70c827-c7c6-45c8-b948-8dbb9a86c41b" alt=""><figcaption><p>VM setup</p></figcaption></figure>

Once the virtual machine is ready with Clete installed, you should initialize clete with the following command:&#x20;

```sh
clete init
```

This will initialize clete to start monitoring for a service and context you've setup previously by asking for the context id and the api keys to the logging platforms.

Once initialization is done, you can run the following to allow clete properly monitoring your services

```
clete processor start -c <cid>
```

```
clete streamer start -c <cid>
```

Ensure the context id for the -c flag are the same for both streamer and processor.

Once, this is done with no errors, Clete is now monitoring your services and will notify you of potential issues. you can monitor the logs of the processor and streamer to verify they are working by running the following comands in your shell

```
clete processor logs -c <cid>
```

```
clete streamer logs -c <cid>
```

If both are working are correctly, you should expect mails like the following if any potential issues are found:

<figure><img src="https://946963100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9K4odSpfS0Z9YZ3rbVjJ%2Fuploads%2FQSmsT5WXXRhjwOfM68f8%2Femail_output_quickstart.jpeg?alt=media&#x26;token=b30c5e54-3afe-498d-bf51-db00fbcdd1a4" alt=""><figcaption></figcaption></figure>
