# System

A **system** represents of the entire system which is the target of optimization.

A system is a single object irrespective of the number or type of entities or layers that are in the scope of the optimization. It can be used to model and describe a wide set of entities like:

* An N-layers application
* A single micro-service
* A single (or a collection of) batch job(s)

A System is made of one or more [components](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/glossary/components). Each component represents one of the elements in the system, whose [*parameters*](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/glossary/parameter) are involved in the optimization or whose [*metrics*](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/glossary/parameter) are collected to evaluate the results of such optimization.

## Construct

A system is described by the following properties:

* The full micro-services stack of an application
* a **name** that uniquely identifies the system
* a **description** that clarifies what the system refers to

The construct to be used to define a system is described on the [System template](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/construct-templates/system-template) page.

## Commands

A system is an [Akamas resource](https://docs.akamas.io/akamas-docs/3.1.3/cli-reference#clireference-operations) that can be managed via CLI using the [resource management commands.](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/cli-reference/cli-reference-2)

## User Interface

The Akamas UI displays systems (depending on the user privileges on the defined [workspaces](https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/glossary/workspaces)) in a specific top-level menu.

<figure><img src="https://3992428493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2bGkjffNK6bMgSMYyrY%2Fuploads%2FouRYhZCmkvJPvREukHAo%2FScreenshot%202022-12-21%20at%2017.23.49.png?alt=media&#x26;token=0f59d1b1-fee7-4e74-9c35-87706f72bf27" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akamas.io/akamas-docs/3.1.3/akamas-reference/glossary/system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.