Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit e0ebcff

Browse files
committed
add dx data cloud
1 parent 64807e1 commit e0ebcff

File tree

1 file changed

+90
-0
lines changed

1 file changed

+90
-0
lines changed

docs/admin/integrations/data-cloud.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
# DX Data Cloud
2+
3+
[DX](https://getdx.com) is a developer intelligence platform used by engineering
4+
leaders and platform engineers.
5+
6+
You can tag your Coder users in DX Data Cloud to filter and analyze user activity data to:
7+
8+
- Measure adoption and impact
9+
- Identify feature usage patterns
10+
- Personalize user experiences
11+
- Proactively address issues
12+
13+
## Requirements
14+
15+
- A DX Data Cloud subscription
16+
- Access to Coder user data through the Coder CLI, Coder API, an IdP, or and existing Coder-DX integration
17+
- Coordination with your Data Cloud Customer Success Manager
18+
19+
## Extract Your Coder User List
20+
21+
<div class="tabs">
22+
23+
You can use the Coder CLI, Coder API, or your Identity Provider (IdP) to extract your list of users.
24+
25+
If your organization already uses the Coder-DX integration, you can find a list of active Coder users directly within DX.
26+
27+
### CLI
28+
29+
Use `users list` to export the list of users to a CSV file:
30+
31+
```shell
32+
coder users list > users.csv
33+
```
34+
35+
Visit the [users list](../../reference/cli/users_list.md) documentation for more options.
36+
37+
### API
38+
39+
Use [get users](../../reference/api/users#get-users):
40+
41+
```bash
42+
curl -X GET http://coder-server:8080/api/v2/users \
43+
-H 'Accept: application/json' \
44+
-H 'Coder-Session-Token: API_KEY'
45+
```
46+
47+
To export the results to a CSV file, you can use the `jq` tool to process the JSON response:
48+
49+
```bash
50+
curl -X GET http://coder-server:8080/api/v2/users \
51+
-H 'Accept: application/json' \
52+
-H 'Coder-Session-Token: API_KEY' | \
53+
jq -r '.users | (map(keys) | add | unique) as $cols | $cols, (.[] | [.[$cols[]]] | @csv)' > users.csv
54+
```
55+
56+
Visit the [get users](../../reference/api/users.md#get-users) documentation for more options.
57+
58+
### IdP
59+
60+
If your organization uses a centralized IdP to manage user accounts, you can extract user data directly from your IdP.
61+
62+
This is particularly useful if you need additional user attributes managed within your IdP.
63+
64+
</div>
65+
66+
## Engage your DX Data Cloud Customer Success Manager
67+
68+
Provide the file to your dedicated DX Data Cloud Customer Success Manager (CSM).
69+
70+
Your CSM will:
71+
72+
1. Import the CSV file into the Data Cloud platform
73+
1. Associate Coder user identifiers with corresponding records in your Data Cloud environment
74+
1. Create the necessary links between your Coder users and their activity data
75+
76+
## Use Coder as a Data Cloud Filter
77+
78+
After the tagging process is complete, you'll have a **Coder** filter option within your Data Cloud dashboards,
79+
reports, and analysis tools that you can use to:
80+
81+
- Segment your data based on Coder usage
82+
- Filter by additional user attributes that are included in your CSV file
83+
- Perform granular analysis on specific segments of your Coder user base
84+
- Understand unique behaviors and patterns across your Coder users
85+
86+
## Related Resources
87+
88+
- [DX Data Cloud Documentation](https://help.getdx.com/en/)
89+
- [Coder API Documentation](../../reference/api/users)
90+
- [PlatformX Integration](./platformx.md)

0 commit comments

Comments
 (0)