Skip to content
Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
83 lines (57 sloc) 3.6 KB
description
Manage your log data sources within Timber

Source Management

Timber's source management section lets you manage all aspects of your log sources.

A "source" is simply a source of log data. For example, a Ruby app, Kubernetes cluster, Linux server, log file, or a AWS Lambda function are all examples of sources within Timber. It is purposefully generic and anything that contains log data is a valid source.

Getting Started

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Click the "Add Source" button.
  4. Select your language, platform, log forwarder, or operating system. Whichever method you prefer to send your log data to Timber.
  5. Click the link to open the appropriate integration instructions.
  6. Follow the instructions to integrate Timber.
  7. Verify log delivery.

Adding A Source To Timber

Usage

Creating

See the Getting Started section.

Updating

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Hover over the source you want to edit and click the context menu icon on the far right.
  4. Click "Settings"
  5. Edit your source as desired.
  6. Click "Update".

Viewing Installation Instructions

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Hover over the source you want to edit and click the context menu icon on the far right.
  4. Click "Installation"

Debugging

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Hover over the source you want to edit and click the context menu icon on the far right.
  4. Click "Installation"
  5. Click on the "Debugger" tab.
  6. Notice the curl command at the bottom. You can use this to test the pipe and verify log delivery is possible.
  7. Head over to the Troubleshooting Log Delivery guide for a deeper debugging guide.

Clearing

Clearing your source simply clears the log data contained but does not delete the source or any associated entities. For example, archives and saved searches will remain.

{% hint style="danger" %} When you clear a source all associated log data is permanently deleted! This is a non-reversible process. Please make sure you have the data you need before proceeding. {% endhint %}

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Hover over the source you want to edit and click the context menu icon on the far right.
  4. Click "Clear"
  5. Click "Clear source" in the "Danger Zone"

Deleting

{% hint style="danger" %} When you delete a source all associated log data is permanently deleted, including archives! This is a non-reversible process. Please make sure you have the data you need before proceeding. {% endhint %}

  1. Open the Timber web app.
  2. Navigate to the Sources section using the main navigation.
  3. Hover over the source you want to edit and click the context menu icon on the far right.
  4. Click "Delete"
  5. Click "Delete source" in the "Danger Zone"
You can’t perform that action at this time.