Skip to content

Commit

Permalink
added tailscale integration tile (#2131)
Browse files Browse the repository at this point in the history
* added tailscale integration

* added copy

* updated codeowners and fixed docs

* fixed issues

* remove non-ascii characters

* remove empty assets in manifest

* remove empty dashboard

* Update tailscale/manifest.json

Co-authored-by: Ursula Chen <[email protected]>

* added new codeowners entry

---------

Co-authored-by: Ursula Chen <[email protected]>
  • Loading branch information
abhimodugula and urseberry authored Oct 25, 2023
1 parent 1237dc7 commit 4c4e40c
Show file tree
Hide file tree
Showing 5 changed files with 108 additions and 0 deletions.
2 changes: 2 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,7 @@
/superwise/ @oryan-omer [email protected] @DataDog/ecosystems-review
/syncthing/ @sashacmc
/taskcall/ @taskcall [email protected] @DataDog/ecosystems-review
/tailscale/ @DataDog/web-integrations
/tidb/ @SabaPing [email protected] @DataDog/ecosystems-review
/tidb_cloud/ @SabaPing [email protected] @DataDog/ecosystems-review
/torq/ @torqio/rnd [email protected]
Expand Down Expand Up @@ -561,6 +562,7 @@
/syncthing/*metadata.csv @sashacmc @DataDog/documentation
/syncthing/manifest.json @sashacmc @DataDog/documentation
/syncthing/README.md @sashacmc @DataDog/documentation
/tailscale/ @DataDog/documentation @DataDog/web-integrations
/taskcall/manifest.json @taskcall [email protected] @DataDog/documentation @DataDog/ecosystems-review
/taskcall/README.md @taskcall [email protected] @DataDog/documentation @DataDog/ecosystems-review
/tidb/*metadata.csv @SabaPing [email protected] @DataDog/documentation @DataDog/ecosystems-review
Expand Down
7 changes: 7 additions & 0 deletions tailscale/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# CHANGELOG - Tailscale

## 1.0.0 / 2023-10-16

***Added***:

* Initial Release
67 changes: 67 additions & 0 deletions tailscale/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Agent Check: Tailscale

## Overview

[Tailscale][1] is a peer-to-peer VPN service that simplifies and secures network connectivity.

With this integration, you can:

1. Control your Tailscale data retention.
2. Build custom widgets and dashboards.
3. Setup your own or leverage out of the box detection rules
4. Cross-reference Tailscale events with the data from other services in your stack.

This integration streams two log types from Tailscale:

[Configuration Audit Logs][4]:

Configuration audit logs let you identify who did what and when in your tailnet. These logs record actions that modify a tailnet's configuration, including the type of action, the actor, the target resource, and the time.

[Network Flow logs][5]:

Network flow logs tell you which nodes connected to which other nodes and when on your Tailscale network. You can export network logs for long-term storage, security analysis, threat detection, or incident investigation.

After parsing your Tailscale logs, Datadog then populates the out-of-the-box Tailscale overview dashboard with insights into security-related events from your physical and virtual traffic.

## Setup

### Installation

The Tailscale check is included in the [Datadog Agent][2] package.
No additional installation is needed on your server.

### Configuration

To enable log streaming:

1. Login to your Tailscale admin console
2. Navigate to the Logs tab
3. Select the **Start streaming** button
From the menu, select Datadog and add a URL + token or [API key][6]
4. Select the **Start streaming** button

## Data Collected

### Metrics

Tailscale does not include any metrics.

### Service Checks

Tailscale does not include any service checks.

### Events

Tailscale does not include any events.

## Troubleshooting

Need help? Contact [Datadog support][3].

[1]: https://tailscale.com/
[2]: https://app.datadoghq.com/account/settings/agent/latest
[3]: https://docs.datadoghq.com/help/
[4]: https://tailscale.com/kb/1203/audit-logging/
[5]: https://tailscale.com/kb/1219/network-flow-logs/
[6]: https://docs.datadoghq.com/account_management/api-app-keys/

1 change: 1 addition & 0 deletions tailscale/assets/service_checks.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
[]
31 changes: 31 additions & 0 deletions tailscale/manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
{
"manifest_version": "2.0.0",
"app_uuid": "e3f4a5cf-3594-43fc-9d4e-4e86b9c91ea2",
"app_id": "tailscale",
"display_on_public_website": false,
"tile": {
"overview": "README.md#Overview",
"configuration": "README.md#Setup",
"support": "README.md#Support",
"changelog": "CHANGELOG.md",
"description": "View Tailscale audit and network flow logs in Datadog.",
"title": "Tailscale",
"media": [],
"classifier_tags": [
"Supported OS::Linux",
"Supported OS::Windows",
"Supported OS::macOS",
"Category::Security",
"Category::Log Collection",
"Category::Network"
]
},
"assets": {},
"author": {
"support_email": "[email protected]",
"name": "Datadog",
"homepage": "https://www.datadoghq.com",
"sales_email": "[email protected]"
},
"oauth": {}
}

0 comments on commit 4c4e40c

Please sign in to comment.