> For the complete documentation index, see [llms.txt](https://itera.gitbook.io/taikun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itera.gitbook.io/taikun/user/projects/project-details.md).

# Project Details - K8s

By clicking the selected project or K8s *View* you are redirected to the **Kubernetes** **Servers**. Here you can see all K8s servers for the project with their description.

![Fig. 1: Accessing Project's details - K8s](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FQ06lJaiURTSiVNVBtz36%2Fservers.gif?alt=media\&token=ef674290-c498-45a0-86a5-8849bd758999)

### Project Info

Under **Servers** title is a brief description of the project - such as *Project Name* (with locked/unlocked image), *Project* *Status*, *Cloud* *Type*, *Kubernetes* *Version*, *Access Profile*,  *Cloud* *Credentials*, *Kubernetes* *Profile*, *Alerting Profile*, *Policy Profile*, *Access IP Address* (if you use this address to ssh connect, please do not use user ubuntu, it's in use by Taikun for managing the cluster) and *Kubernetes Health*.

![Fig. 2: Project Info](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FtWH3XYMezRbU0xNFq8d9%2Fproject-info.png?alt=media\&token=8601f611-b3e8-4735-a35c-1ed3c913644e)

You can also see here ETC=Estimated Time to Complete. It is approx time (in minutes) until the cluster will be completed.

<div align="left"><img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MkgdTHkT4cxIW-88_k8%2F-Mkl_RJST4RBcavASrmV%2Fetc.png?alt=media&amp;token=30a49861-1bef-42f3-a099-b18cef9b5102" alt="ETC"></div>

### Servers

Every Server is described by *ID*, *Server Name*, *IP Address*, *Flavor*, *CPU/RAM/Disk Size*, *Role*, *Status*, *Kubernetes Health* and *Creation Time*. If you expand the table, you can see the last modification made (*Created By*, *Last Modified*, *Last Modified By*).

![Fig. 3: Servers for Project](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2F6v5LgdS99UO0Dig5W4N9%2Fservers.png?alt=media\&token=68c6f36c-e582-436c-8d6c-1697e919398e)

Server status can be:

* Deleting
* Failure
* Pending
* Pending Delete
* Pending Upgrade
* Ready
* Updating
* Upgrading

#### &#x20;**Actions**

### **Upgrade**

Upgrade your version of Kubespray to the latest one.

The button is disabled, if your Kubernetes are up to date. Also if there was chosen to *Auto Upgrade* during creation.

### **Commit**

Sends the changes to the repository.

Once the cluster is committed you will see [**ETC**](https://itera.gitbook.io/taikun/user/projects/project-details#project-info) in project info.

### **Repair**

When the server/s are *Failed* or there is some other problem in the cluster, use repair button.

![Fig.4: Repair](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2F6FQcsouo57P7l0ro8yve%2Frepair.gif?alt=media\&token=2d9780ef-1d82-4a9f-baba-fff091f54a63)

{% hint style="info" %}
If the project is locked:lock: (which you can see under [**Project Info**](https://itera.gitbook.io/taikun/user-guide-1/user/projects/project-details#project-info)), you can only preview some pages (e.g. *Kube Info*). You can't make any changes.
{% endhint %}

### **Add Server**

To create a new server click<img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MZHbYZH5lsyB8T4Ww25%2F-MZIZFCp1zVWNZqbJcFj%2Fadd%20server.png?alt=media&amp;token=f2be7999-3647-4ab3-b0c4-5d81ad594fb0" alt="" data-size="original">button and fill all the fields. You, as user, can't delete servers - think twice which and how many servers you want to create.

![Fig. 5: Add Server](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FGLf1dYgPlvvKT9pJ6igl%2Fadd-server.gif?alt=media\&token=fc20a0ee-c86a-415a-8397-f3d702f2506b)

*Server Name* - only alphanumeric characters and dash are allowed, 1-30 characters

{% hint style="danger" %}
Letters must be lowercase!
{% endhint %}

*Disk size* - should be **at least** 30GB

*Role* - you are able to choose from several roles for your servers, which are set according to the Kubernetes settings

*Number of Servers* - set number for kubeworker or kubemaster, add odd number of masters (min. 3 for a highly available cluster)

{% hint style="warning" %}
The change **MUST** be committed.
{% endhint %}

*Flavor* - choose from the list of offered flavors (e.g. n0.large)

{% hint style="info" %}
Recommendation for sizing:

* *bastion* recommended 2 vCPU + 2GB of RAM
* *masters* recommended 4 vCPU + 8GB of RAM
  {% endhint %}

*Kubernetes Node Labels* - label nodes where you want to sent or restrict pods; you can add more labels with add label button, for more info see [Kubernetes docs](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/)

**Function buttons**

Between *Project Info* and *Servers* are buttons with specific features or more detailed information.

![Fig. 6: Function Buttons](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FaqxGFv2vUaQC1gESQxVF%2Ffunction-buttons.png?alt=media\&token=be1721b2-5798-4d67-aea7-f41f962ae534)

### Kubeconfigs

Add a new kubernetes configuration for your profile and project.

![Fig. 7: Add Kubeconfig](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FHNEbwmX8CgKc8abBlerc%2Fadd-kube-config.png?alt=media\&token=111fd19a-9c4b-481b-aa67-5b72df44da95)

*Kubeconfig Name* - choose a name for your kubeconfig (3-230 characters)

*Kubeconfig Role*

* admin - RoleBinding - allows read/write access to most resources in a namespace, does not allow write access to resource quota or to the namespace itself&#x20;
* edit - allows read/write access to most objects in a namespace, does not allow viewing or modifying roles or role bindings, allows accessing Secrets and running Pods as any ServiceAccount in the namespace
* view - see most objects in a namespace, does not allow viewing roles or role bindings, does not allow viewing Secrets

{% hint style="info" %}
For more info, see[ kubernetes documentation](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles).
{% endhint %}

*Personal Kubeconfig* - kubeconfig can be used only by you

You can see all project's configurations in the table with its *ID*, *Name*, *User* *Name*, *User* *Role*, *Project*, *Accessible for all* and *Actions*.

![Fig.8: Kube Configs](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2FBWm4TxrRrrWT0r9tusan%2Fkubeconfig-overview.png?alt=media\&token=4d131365-320d-4246-be53-512ada09116b)

#### Actions

<img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-McT0x4NgKkVh0AjATAz%2F-McTeo1KbSxWslLLd8Cd%2Fdownload.png?alt=media&amp;token=3186fd15-7b3f-4cd9-a4b5-dfd71e623770" alt="" data-size="original">This .yaml file can be download and use to organize information about clusters, users, namespaces, and authentication mechanisms.

<img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-Mk6UkgYDAHsPXTIGcfJ%2F-Mk6hyRbUTQuKygF4kbB%2Fdelete.png?alt=media&amp;token=048d1ff6-58c8-40c2-adee-b4723a073ce7" alt="" data-size="original">Delete your kube config if it is no longer needed.

### **Kube Info**

If Kubernetes is active, Kube Info button will take you to the Kubernetes configuration. For more see [Projects - **Kubernetes**](https://itera.gitbook.io/taikun/user-guide-1/user/projects/kubernetes).

###

### **Events**

You are redirected to Events, where you can see all Kubernetes changes made in the project. To preview details for more information to each action use<img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MNwXBGwTT91-bGRAbAb%2F-MNwbz5QiOnItn3vUmwl%2Fshow.png?alt=media&amp;token=5311f2d7-e998-4d68-b6dd-019933d28424" alt="" data-size="original">button. A green strip indicates a successful action, a red strip indicates a failed action. Use *Clear events* for deleting all the events.

You can sort Events by:

* *Search* field
* Filling *Start* and *End Date*
* Tick *Only failed* to filter failed actions

![Fig. 9: Events for Monitoring](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MZHbYZH5lsyB8T4Ww25%2F-MZISC9igMLDEziOjK1A%2Fevents.png?alt=media\&token=286b3a2d-0acb-431c-a0c7-d6ee87e10965)

### Logs

Preview Kubernetes cluster logs to Grafana.

Logs button is disabled if *Monitoring* is disabled.

![Fig. 10: Logs](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MZHbYZH5lsyB8T4Ww25%2F-MZITGMaukHgYnuqArk2%2Flogs.png?alt=media\&token=7d34f820-eaf4-4033-b791-7378e32cd764)

Write your query and use *Start date* and *End Date* for sorting. You can also expand every message - red is added action, no color is other.

![Fig. 11: Logs details](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MOWBKrDw0q67FHK4LTi%2F-MOWCtbMOSi5FTEPSeeT%2Flogs%20details.png?alt=media\&token=f6caa6ae-ab34-4667-b3ee-89dbac800a93)

### Alerts

First thing when you access Alerts are *Firing Alerts*. This section is refreshed every 5 minutes, but you can also use the refresh button to see the most updated data.

![Fig. 12: Firing Alerts](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MbC-fiCDddVWLlhEvZc%2F-MbC1LulgpYg0521H_o-%2Ffiring%20alert.gif?alt=media\&token=89881d0d-caca-4e5b-a634-3950fd64d930)

To see all alerts, use upper right *Show All Alerts* button. As seen above, firing alerts are marked with red color. For each alert you can see details and use a link that will redirected you to [**Metrics**](https://itera.gitbook.io/taikun/user-guide-1/user/projects/project-details#metrics) with the query already written.

Alerts are accessible only if *Monitoring* is enabled and the project is not empty.

![Fig. 13: Alerts](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MbC-fiCDddVWLlhEvZc%2F-MbC1RUiT80nYv-d2MlJ%2Ffiring%20alert-%3Emetrics.gif?alt=media\&token=b0e3ed48-40fe-47ed-876a-223ef3738e00)

The index number at *Alerts* shows the number of firing alerts. <img src="https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MRt5VRK5W0uJKr5Ynx3%2F-MRt9DhIj-PY71IDBMpd%2Falerts%20-%20index%20number.png?alt=media&amp;token=5d861e99-3e60-46ca-a0cd-9d6d3b31b729" alt="" data-size="original"> When the firing alerts are resolved, the number disappears.

Firing alerts also work from the real-time notifications bell in the header. Red ones are indicate alert, green ones means that the alert is resolved.&#x20;

![Fig. 14: Alerts bell](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-McDVAlvsx0q-V_DEw6V%2F-McEgMdKz0VKlEtUv-mp%2Ffir%20alerts.gif?alt=media\&token=57979bc7-5275-4f13-b483-39825c951a9c)

The notification contains a brief message on a specific project and bellow the message is time of the change. After clicking *Show Project*, you can access the project in which the alert is.

As the name suggests: *Mark as Read* and *Dismiss all*.

### Metrics

Write a query, search Prometheus Metrics and preview the value needed.

Modify *Step* or *Date*.

Switch between *Console* and *Graph* for better results.

![Fig. 15: Metrics](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJQrhtis3vRAM281R7J%2F-MZHbYZH5lsyB8T4Ww25%2F-MZIXfrJ8lz86zhCHzjU%2Fmetrics.gif?alt=media\&token=09f63c89-d399-4602-823e-cbe151cab65c)

### Project Dashboard

Dashboard is accessible only if cluster is created and monitoring is enabled.

![Fig. 16: Project Dashboard](https://2158992251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJQrhtis3vRAM281R7J%2Fuploads%2F9NSdTe82mCG73RczJKkm%2Fdashboard.gif?alt=media\&token=4d69b312-8757-4da6-ad21-2b2852c0a835)

Here you can see graphs with *Memory* and *CPU* usage for the project. You can also see added Query from [Manager](https://itera.gitbook.io/taikun/manager/projects/project-details#dashboard) or [Partner](https://itera.gitbook.io/taikun/partner/projects/project-details#dashboard).
