# File Server Monitoring

File Server is a centralized location for storing, managing, and sharing files within a network environment. It enables users to manage files efficiently while ensuring security and compliance. Integrating it with IT-Conductor extends its capabilities, particularly with the File Watcher feature designed for SMB (Samba) File Server environments.

Through this integration, users can monitor shares, directories, and individual files in SMB setups, tracking their status and modifications. IT-Conductor allows users to set up alerts for specific file conditions, such as timely arrival, enabling proactive management and enhancing data integrity across the network. Integrating File Server with IT-Conductor's file watcher functionality provides real-time monitoring and control over file-related events, improving operational efficiency and security.

### Prerequisites

Before configuring a file server for monitoring in IT-Conductor, follow the instructions below.

#### Account Requirements

Create or designate an account with read access to the Shares, Folders, and Files that will require monitoring on the Windows Server.

### **Configure** File Server Monitoring **in IT-Conductor**

To configure file server monitoring in IT-Conductor, follow the instructions below.

#### Add a New File Server 

1. Visit [service.itconductor.com](https://service.itconductor.com/) and enter your login credentials.
2. Navigate to **Dashboards → Administrator** to access the **Administrator's Dashboard**.
3. Locate the **File Servers** actions panel and click the title to access the complete list.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F6cdBzn1w18OWU7tMImQ1%2Ffile-servers-actions-panel-administrators-dashboard.png?alt=media&#x26;token=dcb540db-b2b3-4157-b75a-9c368c6c30bd" alt=""><figcaption><p>Figure 1: File Servers Actions Panel in Administrator's Dashboard</p></figcaption></figure>

4. Click the ![](https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F4XczzQEn6qTb8HbIJ5pP%2Fimage.png?alt=media\&token=1f26d02a-91cf-4732-86d6-f54c863361c5) icon to add a new file server

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F2reJoqTJLI3FfgEI7REy%2Ffile-servers-actions-panel-page.png?alt=media&#x26;token=8706f71a-2b0e-4822-b525-c78dd8fad163" alt=""><figcaption><p>Figure 2: File Servers Actions Panel Page</p></figcaption></figure>

5. Fill out all the necessary information in the **New File Server** wizard. Once completed, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to add the system.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F0sXZe3mOR00pE9AlmZq9%2Fimage.png?alt=media&#x26;token=ab5762b9-1891-42d9-b52d-dd181d9fe56f" alt=""><figcaption><p>Figure 3a: New File Server Wizard (New File Server Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the file server being added.
* **Organization** - refers to an administrative structure that defines objects with a common goal or purpose. If you previously created an organization, please select it.
* **Role -** refers to the environment where the system will be used.
* **Site** - refers to a logical object that describes a particular area or location, depending on the context in which it is used.
* **Gateway** - allows communication between the customer's site network and the IT-Conductor cloud platform. Select the previously configured gateway from the dropdown menu. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Server Name** - refers to the name of the server that will be added.
* **SMB2** - refers to the network communication protocol used for file sharing.

6. Provide the account information in the wizard and click <img src="https://docs.itconductor.com/~gitbook/image?url=https:%2F%2F377464071-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXhp08OmU8050PePmMgDt%252Fuploads%252Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%252Fadd.png%3Falt=media&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=e691117173a2adddeb4af6cbe6c2cd5535f4de6b5205247208ca52eb94ee71db" alt="" data-size="line"> to complete the configuration.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fa3Ee68i7Cc1rG38vTRwP%2Fnew%20file%20server%20account.png?alt=media&#x26;token=d2766b22-f848-451a-aa7a-5a1940e1ec02" alt=""><figcaption><p>Figure 3b: New File Server Wizard (New Account Screen)</p></figcaption></figure>

* **Description -** refers to any relevant information about the user account being added.
* **Application** - refers to the previously added file server.
* **Person** - refers to the name of the user who is adding the server.
* **User** - refers to the user aligned with the [Account Requirements](#account-requirements).
* **Password** - refers to the password of the previously created user.
* **Retype Password** - refers to the same password provided in the **Password** field.

7. Verify if the system was added to the **File Servers** actions panel and check its status.

{% hint style="info" %}
**Note:** The status will remain on **Ready** for a few minutes. Refresh the panel if needed. If there are configuration issues, such as incorrect connection parameters or an invalid account, the status will remain **Ready**. Click ![](https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FhBg7vkJHopp4Ptd9vKo8%2Fimage.png?alt=media\&token=7a48e001-c7b9-41dc-a244-20e1c40c8dcb) to display the log and troubleshoot as needed. If everything is configured correctly, the status will change to **In Progress.**
{% endhint %}

9. Navigate to the service grid and verify if the system was added under the **File Servers** nod&#x65;**.**

{% hint style="info" %}
**Note:** The system will appear in the service grid within 5-15 minutes.
{% endhint %}

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F88gbqNUrGvY7rgHoeo2x%2Fimage.png?alt=media&#x26;token=6b6aca27-20a5-4a1e-811e-c48aa3daddea" alt=""><figcaption><p>Figure 6: File Servers in IT-Conductor Service Grid</p></figcaption></figure>

### Monitor File Servers in IT-Conductor

To view the availability and performance metrics of a File Server, locate the **File Server** node in the service grid.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FEnhR7b8bOSBW0xp20wv7%2Fgit%20server%20service%20grid.png?alt=media&#x26;token=2de012c2-50cb-47fb-8555-4c7e3bd3905f" alt=""><figcaption><p>Figure 7:  File Server View in Service Grid</p></figcaption></figure>

#### **File Server Key Metrics**

* **Availability** - refers to the operational state and accessibility of the File Server.
* **Connection Failures** - refer to the events where attempts to establish a connection are unsuccessful.
* **Heartbeat** - refers to the periodic signal sent to the system, enabling real-time detection of system downtime.
* **Missing Account** - refers to the absence of a required user account or resource within the File Server.
* **Retriever Failures** - refer to the errors or issues encountered during the retrieval process of essential data or information within the File Server.

{% hint style="info" %}
**Note:** All metrics will not show data when a system is unavailable.
{% endhint %}

To access a historical view of these metrics, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FNOdVLMVvoIIweSff3LA5%2Fimage.png?alt=media&#x26;token=12bc98a0-364d-4a08-bab9-e24d0d9ac6f6" alt="" data-size="line">and a pop-up chart will be displayed.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fvc4OT5HnmE7wSJBRwbk5%2Fimage.png?alt=media&#x26;token=18db0e36-75fe-4576-a11a-03da75535f9f" alt=""><figcaption><p>Figure 8: Availability Chart in Service Grid</p></figcaption></figure>

#### **Health Explorer**

To view a more detailed analysis of metrics and time-synchronized data, click **Health** in the service grid, and you will be redirected to the **Health Explorer** page.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FVEz3KeZ0J9WKj49iHAKt%2Fgit%20server%20health.png?alt=media&#x26;token=bae82107-6b1f-4c5f-9fde-e0c166ed3f4e" alt=""><figcaption><p>Figure 9a: File Server Health Explorer</p></figcaption></figure>

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FTnP4QRF5fhuEi0749KZR%2Fgit%20server%20health2.png?alt=media&#x26;token=de10d08a-fbd2-46e7-b28b-3055be1f7476" alt=""><figcaption><p>Figure 9b: File Server Health Explorer</p></figcaption></figure>

#### **Application Log**

An application log records events or messages generated by software during its execution. It is typically used for debugging and troubleshooting purposes.

To view the logs for the file servers, click **Application Log** in the service grid, and you will be redirected to a page with a list of all events and their status.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FHKGE2vrpe7dT3UrusxU9%2Fimage.png?alt=media&#x26;token=9e09fda5-d385-4454-a6bb-281768bae559" alt=""><figcaption><p>Figure 10: File Server Application Log</p></figcaption></figure>

#### **Scheduled Maintenance Events**

To view the scheduled maintenance events for monitored File Servers, click **Events** in the service grid, and a pop-up list of **Scheduled Maintenance Events** will be displayed.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FJBwsTsrVH8z6z8djzxRw%2Fgit%20server%20events.png?alt=media&#x26;token=54b7fb47-9a65-45a5-bafa-9d1eaa35d4a5" alt=""><figcaption><p>Figure 11a: File Server Scheduled Maintenance Events</p></figcaption></figure>

To schedule a maintenance event, click ![](https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FIyVCaRISQllVyJTraDLL%2Fimage.png?alt=media\&token=175b4801-4d9d-4df7-ba26-55aad0b2e177) and you will be redirected to a page listing all maintenance events associated with the file server. Then click **Create New Maintenance Events.**

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Ffm2x67EJ6kxkSv10d4If%2Fgit%20server%20events2.png?alt=media&#x26;token=99164cae-2d4b-4021-b5ef-49387bde50b1" alt=""><figcaption><p>Figure 11b: Create a New Maintenance Event</p></figcaption></figure>

### Related Information

Please refer to the [File Watcher Documentation](https://docs.itconductor.com/user-guide/monitoring/infrastructure/file-server/file-watcher) to learn how to monitor the information within the shares, folders, and files.