Skip to content

PlanetHoster/transfer-logs-to-n0c-storage-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Transfer Logs To N0C Storage

N0C

This is a JavaScript script that can be used to transfer logs from your server to N0C Storage.

Consequently, this allows you to save space and avoid cluttering your SSD, while still keeping your logs accessible.

This script can be used as a starting point to create more complex scripts or integrated directly into an application.

In this example, we set up a cron job to run the script twice a day.

What is N0C Storage?

N0C Storage is a platform designed to store massive files such as backups, archives and items that do not require a high-performance disk (SSD).

Learn more about N0C Storage

Requirements

  • Node.js application on your server which generates logs
  • S3 JavaScript SDK (e.g. minio)
  • Dotenv package (e.g. dotenv)
  • SSH access to your server Learn more

Installation

Note: Replace username with your server username and myapp with your application name.

  1. SSH into your server or alternatively use N0C Terminal

    terminal.png

  2. Source the application environment

    source /home/username/nodevenv/myapp/20/bin/activate

    The command to source the environment may vary depending on the application and the environment name.

    You can find the correct command in the application tab.

    source-command.png

  3. Install the required packages

    npm install minio dotenv

    If you are using a different S3 SDK, replace minio with the correct package name.

  4. Create a folder for the script

    mkdir /home/username/cron-scripts/transfer-logs/
  5. Create a new file in the folder

    touch /home/username/cron-scripts/transfer-logs/transfer-logs-to-n0c-storage.js
  6. Copy the script content from the repository to the file

    nano /home/username/cron-scripts/transfer-logs/transfer-logs-to-n0c-storage.js

    Paste the content and save the file.

    Note: Alternatively, steps 4-6 can be done via N0C's file manager.

    filebrowser.png

  7. Create a .env file in the same folder

    touch /home/username/cron-scripts/transfer-logs/.env
  8. Add the following content to the .env file, replacing the placeholders with your data

    S3_BUCKET=bucketname
    S3_HOST=hostname
    S3_PORT=port
    S3_ACCESS_KEY=accesskey
    S3_SECRET_KEY=secretkey
    S3_SSL=true
    
    PATH_TO_LOGS=your-log-path
    APPLICATION_LOG_FILENAME=your-log-filename
    ERROR_LOG_FILENAME=your-error-log-filename
    
    N0C_STORAGE_LOG_PATH=your-n0c-storage-path

    Note: Your N0C Storage credentials can be found here: n0c-storage-creds.png

  9. Create the cron job via the interface

    new-cron.png

    In the command field, add the following command:

    source /home/username/nodevenv/myapp/20/bin/activate && node /home/username/cron-scripts/transfer-logs/transfer-logs-to-n0c-storage.js

    To run the script twice a day, select twice a day in the common parameters field

Done! Your logs will now be transferred to N0C Storage twice a day.

Running the script manually

To run the script manually:

  1. SSH into your server or alternatively use N0C Terminal

  2. Source the application environment

    source /home/username/nodevenv/myapp/20/bin/activate
  3. Run the script

    node /home/username/cron-scripts/transfer-logs/transfer-logs-to-n0c-storage.js

    srcipt-output.png

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published