-
Notifications
You must be signed in to change notification settings - Fork 765
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
added tailscale integration tile (#2131)
* 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
1 parent
1237dc7
commit 4c4e40c
Showing
5 changed files
with
108 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -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] | ||
|
@@ -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 | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/ | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
[] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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": {} | ||
} |