---
title: Data Export
slug: legacy/data-export
description: Discover the efficient Logs Export Service designed for DNS Proxy browsing logs, allowing easy exportation in compressed *.tar.gz* files.
docTags: 
createdAt: 2024-08-05T07:52:51.042Z
---

The Logs export service allows the export of DNS Proxy browsing logs.
The browsing logs are compressed into files with the extension **.tar.gz** and sent every 5 minutes by ISP-type DNS Proxies and every hour by DNS Proxies with Active Directory.

If the file is not transferred, it remains pending and is transferred at the next execution.
In case the same remote host is configured on two or more DNS proxies.
To avoid file conflict problems, one of the following options should be chosen:


- configure on the DNS Proxy a unique hostname for each device;
- configure multiple destination folders in the Data Export, one for each DNS Proxy.

**Note:**

- Untransferred files remain in pending status for up to 2 days, but in the case of 95% occupied disk space, all pending files are deleted.
- The date entered in the logs is set with [Timezone BST](https://dateful.com/convert/british-summer-time-bst). 
- The file name will be in the format: bind-HOST\_NAME-YYYYMMDDHHMMSS.tar.gz
  Where HOST\_NAME is the machine name, YYYYMMDDHHMMSS is the timestamp of the file creation *(e.g., bind-dns\_proxy\_test-20231002101500.tar.gz).*

To manage the service access the admin panel in \[A] - Advanced configuration " \[L] - Logs export. 



::Image[]{src="https://api.archbee.com/api/optimize/qeNTDI134aDAkmAtZMoNc/NIaaxFIVTQFYLiS20VGv1_image.png" size="50" width="405" height="262" position="center" caption="prompt" alt="command prompt" darkWidth="800" darkHeight="518" showCaption="true"}

##

<font color="#ff361d"> </font>*Access theLogs export menu*

<font color="#ff361d"> </font>Activate the service by typingy and pressing ENTER.

<font color="#ff361d"> </font>*Sending mode&#x20;*: enter the file sending mode and press ENTER:

- **SFTP&#x20;**&#x73;upports password and public key authentication methods
- **SCP&#x20;**&#x73;upports only public key authentication methods&#x20;

<font color="#ff361d"> </font>*Remote host*: enter the domain or IP of the host on which to send data

<font color="#ff361d">**5.**</font> *Remote port*: enter the port of the host on which to send data

<font color="#ff361d"> </font>*Username*: enter the user enabled to send

<font color="#ff361d">**7.**</font> *Login mode*: enter the authentication mode:

- **password&#x20;**&#x66;or user and password authentication, available in SFTP sending mode **- sshkey&#x20;**&#x66;or public key authentication.
- In this case, it is necessary to copy the key of the DNS proxy to the target host destination, see <u>**Menu Logs export » View local SSH Key.**</u>

<font color="#ff361d">**8.** </font>Only if *Login mode = password*, Enter password: enter the login password for the remote host.

<font color="#ff361d">**9.**</font> *Remote path&#x20;*: enter the destination path to the files.

<font color="#ff361d">**10.**</font> Confirm the configuration by typing y and pressing ENTER.

<font color="#ff361d">**11.**</font> On the next screen:

- <u>If </u><u>**sshkey&#x20;**</u><u>access mode was selected</u>, type y and press ENTER to display the local SSH key to be entered into the target host.
- You can also view the key later via the Logs export menu <u>**Menu Logs export » View local SSH Key.**</u>
- <u>If </u><u>**password&#x20;**</u><u>access mode was selected type </u><u>**&#x20;&#x20;**</u>**y&#x20;**&#x61;nd press ENTER to proceed to test sending a file.

It is also possible to test file sending at a later time via <u>**Menu Logs export » Test export**</u>

##

If the service is active the saved configuration is shown, type y and press ENTER to access the Logs export service management

If the service is not active you are asked to activate the service, type y and press ENTER to proceed to activation.

**Example active service configuration:**

::Image[]{src="https://api.archbee.com/api/optimize/qeNTDI134aDAkmAtZMoNc/-t22zJB3DBH6KOC-H3_xJ_image.png" size="50" width="376" height="244" position="center" caption="prompt" alt="command prompt" darkWidth="800" darkHeight="519" showCaption="true"}

**Service management menu:**

::Image[]{src="https://api.archbee.com/api/optimize/qeNTDI134aDAkmAtZMoNc/1PR5mMIE8tQwMHu33MOlC_image.png" size="50" width="373" height="225" position="center" caption="prompt" alt="type y" darkWidth="800" darkHeight="483" showCaption="true"}

## Disable service

Access the menu to disable the Logs export service.

<font color="#ff361d">**1.**</font> Access the \[D] - Disable service menu.

<font color="#ff361d">**2.**</font> Type y and press ENTER to confirm the deactivation.

##

Access the menu to change the configuration of the Logs Export service.

**Notes:**


This screen is also shown when reactivating the service.
Values in square brackets are those previously configured, press ENTER to confirm the previous value:

<font color="#ff361d">**1.**</font> Access the \[C] - Change configuration menu.

<font color="#ff361d">**2.**</font> Sending mode: enter the file sending mode and press ENTER:

- SFTP
  supports password and public key authentication methods
- SCP
  supports only public key authentication methods

<font color="#ff361d">**3.**</font> Remote host: enter the domain or IP of the host on which to send data.

<font color="#ff361d">**4.**</font> Remote port: enter the port of the host on which to send data.

<font color="#ff361d"> </font>Username: enter the user enabled to send.

<font color="#ff361d">**6.**</font> Login mode: enter the authentication mode:

- password
  for user and password authentication, available in SFTP sending mode;sshkey
  for public key authentication.
  &#x20;In this case, it is necessary to copy the key of the DNS proxy to the target host destination, see **[Menu Logs export » View local SSH Key ](https://cloud.flashstart.com/customerarea/support/docsisp/#:~\:text=host%20destination%2C%20see-,Menu%20Logs%20export%20%C2%BB%20View%20local%20SSH%20Key,-.%0A%0A7.%20Only)**&#x4F;nly if Login mode = password, Enter password: enter the login password for the remote host.
- Remote path: enter the destination path to the files.

<font color="#ff361d"> </font>Confirm the configuration by typing y and pressing ENTER.

<font color="#ff361d"> </font>On the next screen, type y and press ENTER to proceed to test sending a file.

<font color="#ff361d">**9.**</font> It is also possible to test file sending at a later time via the menu Menu Logs export » Test export.

##

Access the menu to view the local SSH key.

**Notes:**


This menu is not displayed if SFTP sending mode with user and password authentication method has been chosen:

 <font color="#ff361d">**1.**</font> Access the menu V View local SSH Kec <font color="#ff361d"> </font>
The screen shows the local SSH key as the expample below:



::Image[]{src="https://api.archbee.com/api/optimize/qeNTDI134aDAkmAtZMoNc/otfn-px6RUJUxFsvqOVua_image.png" size="50" width="716" height="289" position="center" caption="Local SSH key" alt="Local SSH key" showCaption="true"}

To authorize access to the SFTP host, it is necessary to:

- select the text;
- copy it;
- paste it into the authorized\_keys file of the SFTP host on the configured user
  e.g. on Linux with user user\_export the file path could be
  /home/user\_export/.ssh/authorized\_keys.

&#x20;<font color="#ff361d"> </font>Permit ENTER to return to the Logs export menu.

##

Access the menu to perform the export of a test file.

The file will be named with export-SYSTEMNAME\_DNSPROXY.txt and exported to the configured destination folder:

<font color="#ff361d">**1.** </font>Access the \[T] - Test export menu.

<font color="#ff361d">**2**</font><font color="#ff361d">**.** </font>Type y and press ENTER to send the file.
(Wait for the procedure to run).

****Test result:

- If the file was exported, the message File exported is displayed
  successfully!
- If errors were encountered, the message ERROR: Unable to export file and any error log are displayed.

<font color="#ff361d">**4.**</font> Permit ENTER to return to the Logs export menu.



**Other ways to ask**:

- Configure on the DNS Proxy a unique hostname for each device.
- Configure multiple destination folders in the Data Export.