Connect User Metrics #181

jakubnowicki · 2025-06-17T12:57:43Z

Dashboard for presenting the adoption data for the content deployed on Posit Connect, created by Appsilon.

Standalone repository: https://github.com/Appsilon/ConnectUserMetrics

…rics-prepare-manifest-files

add connect-user-metrics dir

…metrics

update links with shortener

Add About the app section

Pre-release manifest.json update.

dotNomad

Howdy @jakubnowicki 👋

Thanks for submitting this PR to contribute to the Connect Gallery! I'm still working through this PR to give it a full review, but I figured I'd post my in progress comments and questions so we could start some back and forth while I work through it.

dotNomad · 2025-06-20T20:19:09Z

extensions/connect-user-metrics/README.md

@@ -0,0 +1,55 @@
+# Connect Insights Dashboard


Great README. I noticed you included a short description in the manifest.json, but it could be helpful to add a description here as well. Perhaps one even longer that gives an indication of what functionality to expect.

Additionally I see the "Connect Insights Dashboard" naming here, but the directory and manifest.json use "Connect User Metrics" I was curious about the difference in naming.

Excellent idea! I will copy the content of the in-app "help button" here, so we have a better description of what the app really does.

About the naming convention: you are right, we will stick to "Connect User Metrics".

dotNomad · 2025-06-20T20:20:42Z

extensions/connect-user-metrics/README.md

+Confirm with your Posit Connect admin that instrumentation is enabled.
+
+<!-- Links -->
+[User Guide Vars]: https://docs.posit.com/connect/user/content-settings/#content-vars  


Looks like there is a typo here.

Suggested change

[User Guide Vars]: https://docs.posit.com/connect/user/content-settings/#content-vars

[User Guide Vars]: https://docs.posit.co/connect/user/content-settings/#content-vars

Nice catch!

dotNomad · 2025-06-20T20:24:22Z

extensions/connect-user-metrics/app/constants/filter_users.yml

I noticed there are some features not included in the README that are in the Appsilon/ConnectUsersMetrics repo README. That totally makes sense given how the READMEs will be consumed for Gallery content.

It makes me wonder if there should be a CONTRIBUTING guide here that includes some of those details so this file, for example, is a bit easier to understand.

This app here is a simplified version of the origina Connect User Metrics; some of the features only make sense in the complete app, where the user is able to modify some configuration files.

I will add a CONTRIBUTE file pointing to the original branch.

dotNomad · 2025-06-20T20:25:44Z

extensions/connect-user-metrics/app/js/index.js

It looks like the js file is empty other than this one file. Is there a reason to keep it around that I'm missing?

You are right! These files (together with Cypress testing) are automatically generated Rhino, the framework we used to make this app. I will delete it for the sake of simplicity.

dotNomad · 2025-06-20T20:57:23Z

extensions/connect-user-metrics/tests/cypress/e2e/app.cy.js

It looks like the Cypress tests aren't used here and there isn't a package.json to setup Cypress with npm. Can we remove the Cypress config and this empty test file?

When Cypress tests are added in the future we can get them added back :)

(Same answer as above; I will delete the file).

dotNomad · 2025-06-20T21:00:13Z

extensions/connect-user-metrics/app/static/css/app.min.css

It looks like this is being generated from main.scss. but I'm curious how this is being generated. I don't see anything mentioned in the README here or over in https://github.com/Appsilon/ConnectUserMetrics

Forgive me this may be some of my own unfamiliarity with styling Shiny apps.

The minified CSS is generated by running rhino::build_sass(); it is a common practice when using Rhino, but we probably can make that more clear in the main repository of Connect User Metrics.

…-fixes' into pre-connect-release-fixes

vituri · 2025-06-24T00:07:28Z

Hey, @dotNomad , thank for the quick review! Jakub is on vacation right now, so I will try to answer some of your comments. I made a PR-to-this-branch fixing the issues you pointed. As soon as Marcin approves it, we can make a new round of reviews.

Copy changes from main-connect-extension

toph-allen

This generally looks really cool, and thank you for submitting the PR! Not quite ready to approve yet. I have a few small comments in this review — not all are direct things that need to be changed, but a few are.

I'll sum a few things up here:

The file list in the manifest references at least one file that doesn't exist (app/js/index.js), so I couldn't test out the deploy as specified to a Connect server.
dependencies.R isn't needed any more (thanks @jonkeane for pointing that out).

Other things that I'll dig into more next week:

Running the app locally on my computer (with CONNECT_SERVER and CONNECT_API_KEY defined), I was unable to get the app to display data correctly. Like I said, I'll dig into this more at the start of next week to see if I can diagnose the issue.
I had trouble getting renv::restore() to run correctly. Some versions of certain packages recorded in renv.lock try to install from source from the Public Package Manager server, which results in compiler failures. I was able to get packages to install correctly with renv::install().

Again, thanks for submitting this, and looking forward to getting it in the Gallery!

toph-allen · 2025-06-27T21:56:39Z

extensions/connect-user-metrics/app/logic/data_utils.R

+get_usage_from_client <- function(client, from = NULL, to = NULL, guids = NULL) {
+  usage <- get_usage_shiny(
+    client,
+    limit = Inf, content_guid = guids, from = from, to = to
+  )
+
+  usage
+}


There is a forthcoming get_usage() function in connectapi which will return usage from a newer endpoint which returns data in a slightly different format. Although the newer endpoint doesn't accept a guids argument, and so returns all hits between the provided dates, it isn't paginated, so it's almost always faster than the older usage endpoints.

This isn't an actionable change now, but it should be merged and released soon. (There is some code in the Usage Metrics Dashboard gallery app that calls this endpoint.

toph-allen · 2025-06-27T22:22:30Z

extensions/connect-user-metrics/dependencies.R

@@ -0,0 +1,24 @@
+# This file allows packrat (used by rsconnect during deployment) to pick up dependencies.


rsconnect / packrat leverage renv for dependency detection now, so they pick up on box imports, so this file isn't needed.

Thanks for pointing that out! I have brought it up some time ago too in hopes we would move Rhino away from this approach, but we need to be considerate to not break too many things.

Bottom line is: it's fine to remove the file and I did so in 3363159.

toph-allen · 2025-06-27T22:23:48Z

extensions/connect-user-metrics/manifest.json

+        "Version": "0.9-40",
+        "Date": "2022-03-21",
+        "Authors@R": "c(person(given = \"Torsten\", family = \"Hothorn\", role = \"aut\", email = \"[email protected]\",\n                    comment = c(ORCID = \"0000-0001-8301-0471\")),\n             person(given = \"Achim\", family = \"Zeileis\", role = c(\"aut\", \"cre\"), email = \"[email protected]\",\n                    comment = c(ORCID = \"0000-0003-0918-3766\")),\n             person(given = c(\"Richard\", \"W.\"), family = \"Farebrother\", role = \"aut\", comment = \


This file isn't present in the repo, so deployment via the manifest fails.

toph-allen · 2025-07-02T22:16:38Z

I wanted to add a bit more detail to my above reports of being unable to load data in the app. @dotNomad and I walked through these steps again today. Here are the steps we took:

Clone this branch.
Run renv::restore().

This failed, running on R 4.5.1 (for reference, the lockfile was generated under R 4.5.0), with a compile error from Matrix 1.7-2. The local R environment was configured to use the Posit Public Package Manager, which matches the lockfile.

Run renv::install() to install detected dependencies.

Attaching the resulting renv.lock in case it's helpful: renv.lock.zip

Ran the app with rhino::app().

We ran the app against two different Connect servers.

Against one server, users and applications appeared as GUIDs. Against another, users and applications show correctly in the filter lists but no data is loaded. We see errors in the browser's console like the following, and no output in the R console.

inputValidateDecorator.ts:16 Uncaught Error: Unexpected input value mode: 'undefined'
    at Oi (inputValidateDecorator.ts:16:13)
    at Ot.setInput (inputValidateDecorator.ts:37:21)
    at Co (bind.ts:42:12)
    at bind.ts:280:11
    at HTMLDivElement.<anonymous> (virtual-select.js:2:123801)
    at HTMLDivElement.dispatch (jquery.js:5145:27)
    at HTMLDivElement.<anonymous> (jquery.js:4949:28)
    at virtual-select.js:2:37123
    at Array.forEach (<anonymous>)
    at virtual-select.js:2:37100
Oi @ inputValidateDecorator.ts:16
setInput @ inputValidateDecorator.ts:37
Co @ bind.ts:42
(anonymous) @ bind.ts:280
(anonymous) @ virtual-select.js:2
dispatch @ jquery.js:5145
(anonymous) @ jquery.js:4949
(anonymous) @ virtual-select.js:2
(anonymous) @ virtual-select.js:2
setTimeout
value @ virtual-select.js:2
value @ virtual-select.js:2
value @ virtual-select.js:2
value @ virtual-select.js:2
receiveMessage @ virtual-select.js:2
(anonymous) @ shinyapp.ts:762
await in (anonymous)
_sendMessagesToHandlers @ shinyapp.ts:697
await in _sendMessagesToHandlers
dispatchMessage @ shinyapp.ts:672
(anonymous) @ shinyapp.ts:256
startActionQueueLoop @ shinyapp.ts:284
await in startActionQueueLoop
(anonymous) @ shinyapp.ts:253

Let us know if there’s something else we should try to get it working.

toph-allen · 2025-07-16T17:56:34Z

Hi @jakubnowicki — just wanted to ping you on this to see if there are any updates.

toph-allen · 2025-07-29T20:48:53Z

Hi @jakubnowicki — just following up again. We’re still interested in getting this app into the Connect Gallery, and happy to work with you to get it across the finish line!

jakubnowicki · 2025-07-31T11:00:09Z

Hi @jakubnowicki — just following up again. We’re still interested in getting this app into the Connect Gallery, and happy to work with you to get it across the finish line!

Hi @toph-allen, apologies for the delay. We should be able to push some changes soon.

TymekAppsilon · 2025-07-31T12:06:57Z

@toph-allen, I also ran into the issues when running renv::restore(). It seems that some of the versions recorded in renv.lock were quite old and their binaries got dropped by P3M. As we don't really use anything specific there, I upgraded the dependencies (and renv.lock accordingly) which appears to have resolved the issues.

I updated the manifest too and tested the app against our internal Connect instance—the metrics seemed to work for me! Could you take a look if it works on your end too?

toph-allen · 2025-08-04T21:45:31Z

@jakubnowicki @TymekAppsilon Thanks for the updates; we'll take a look soon!

toph-allen

Hi @TymekAppsilon & others — thanks for the updates!

I successfully ran renv::restore() locally on my machine, and was able to deploy the app successfully to two internal Connect servers.

One issue I encountered: On one of the servers I tested against, both the applications and users appear as GUIDs (with no names) in the left-hand sidebar. Perhaps helpful for tracking down the issue: The names display correctly in the tables in the app's content area. I should note that this server has a lot of content deployed on it, and may have some malformed names in the data

I'll bring this updated versio to team to figure out what we need to do to move the process forward and to see what other checks are required. (For example — I think most of our Gallery apps require R 4.3.0, so as part of the process of bringing this into the Gallery, we may try to bump the required version of R down.)

TymekAppsilon · 2025-08-18T10:40:36Z

@toph-allen I found the culprit. It's a mix of how we fill the missing title returned by connectapi::get_content and how shinyWidgets::virtualSelectInput handles NA in names of its choices arguments.

For the apps, an entry returned from get_content that has is missing both name and title makes virtualSelectInput fall back to displaying values for all its choices.

I will fix this on Thursday (August 21). For apps I will use GUID as the display name when both name and title are missing. I'll check what is the issue with users too.

Please let me know if you want me to downgrade to R 4.3 right away. I don't think we use anything in particular from later R versions.

TymekAppsilon · 2025-08-21T08:25:56Z

@toph-allen should be all sorted out!

78b7868 fixes the app names
95f7b20 fixes the usernames
33fbddf downgrades to R 4.3.1

toph-allen · 2025-08-28T15:10:30Z

Hey @TymekAppsilon! Thanks for the updates, and and for your patience — I just wanted to let you know that I'll be getting to this soon!

vituri and others added 20 commits June 6, 2025 14:35

add connect-user-metrics dir

aac0e77

add manifest file

ad72f9d

add connect-user-metrics to enxtensions.yml

6820cb0

shorter readme

627dabf

use Posit package manager

93a2a8a

add dot-files

94e6b43

Merge remote-tracking branch 'origin/copy-user-metrics' into user-met…

e8baeaa

…rics-prepare-manifest-files

use posit package manager

6ac0883

remove goal lines from config.yml

7107381

indent manifest.json

42436cf

Merge pull request #5 from Appsilon/copy-user-metrics

4572c0f

add connect-user-metrics dir

fix homepage link

8ba0141

remove tags; update description

4d0401a

Merge branch 'user-metrics-prepare-manifest-files' into connect-user-…

d9d70f7

…metrics

update links

a1861d1

Merge pull request #6 from Appsilon/use-shortener-links

18ee46d

update links with shortener

Add About the app section

18e8d93

Merge pull request #9 from Appsilon/update-modal-text

e772ebc

Add About the app section

Pre-release manifest.json update.

6133051

Merge pull request #10 from Appsilon/pre-release-adjustments

2a282bb

Pre-release manifest.json update.

dotNomad self-requested a review June 17, 2025 16:20

dotNomad reviewed Jun 20, 2025

View reviewed changes

vituri mentioned this pull request Jun 23, 2025

Pre connect release fixes Appsilon/ConnectUserMetrics#11

Merged

3 tasks

vituri added 3 commits June 23, 2025 21:01

copy changes from main-connect-extension

499ba46

copy changes from main-connect-extension

be09423

Merge remote-tracking branch 'refs/remotes/origin/pre-connect-release…

bba6a4f

…-fixes' into pre-connect-release-fixes

Merge pull request #14 from Appsilon/pre-connect-release-fixes

f31a566

Copy changes from main-connect-extension

toph-allen requested changes Jun 27, 2025

View reviewed changes

TymekAppsilon added 5 commits July 31, 2025 12:42

build: upgrade dependencies

3601137

build: add rsconnect

ddf8e3a

refactor: address lints

c772ce2

build: remove unused dependency

2baadba

build: remove dependencies.R

3363159

TymekAppsilon added 6 commits July 31, 2025 13:05

fix: set window_title

d1961cf

chore: update manifest.json

83a9fc9

Merge remote-tracking branch 'upstream/main' into connect-user-metrics

4803442

docs: update dead link

9c357c2

chore: remove unused file

7fb37de

chore: update manifest.json

e3490d2

toph-allen reviewed Aug 8, 2025

View reviewed changes

TymekAppsilon added 5 commits August 21, 2025 09:38

style: update wording

f31f418

fix: fall back to GUID when both name and title are missing

78b7868

fix: fall back to GUID when username is missing

95f7b20

fix: handle connection issues gracefully

583691c

build: downgrade to R 4.3.1

33fbddf

	[User Guide Vars]: https://docs.posit.com/connect/user/content-settings/#content-vars
	[User Guide Vars]: https://docs.posit.co/connect/user/content-settings/#content-vars

		@@ -0,0 +1,24 @@
		# This file allows packrat (used by rsconnect during deployment) to pick up dependencies.

Connect User Metrics #181

Are you sure you want to change the base?

Connect User Metrics #181

Uh oh!

Conversation

jakubnowicki commented Jun 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dotNomad left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vituri commented Jun 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

toph-allen left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

toph-allen commented Jul 2, 2025

Uh oh!

toph-allen commented Jul 16, 2025

Uh oh!

toph-allen commented Jul 29, 2025

Uh oh!

jakubnowicki commented Jul 31, 2025

Uh oh!

TymekAppsilon commented Jul 31, 2025

Uh oh!

toph-allen commented Aug 4, 2025

Uh oh!

toph-allen left a comment

Choose a reason for hiding this comment

Uh oh!

TymekAppsilon commented Aug 18, 2025

Uh oh!

TymekAppsilon commented Aug 21, 2025

Uh oh!

toph-allen commented Aug 28, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

jakubnowicki commented Jun 17, 2025 •

edited

Loading

vituri commented Jun 24, 2025 •

edited

Loading