Early accessBy invitation, and the SDKs aren't published yet.Ask for an invitation
Skip to Content
Docs

Platforms

One project can hold an app, its website and its backend, and the dashboard can show each on its own.

A project can hear from several parts of a product: a game's iOS app, its website and its API can all send to one project. One person (by user_id) can then be followed across them, and the dashboard can still show one part at a time.

There are two sides to this: the platform field on each event, and the list of platforms you set up on the project.

The platform on each event

Every event carries a platform: which part of the product sent it. The SDKs send:

SDKPlatform
SwiftThe OS: ios, macos, tvos or visionos; apple on watchOS
Androidandroid
React Native, FlutterThe OS, from the native SDK underneath: ios or android
JavaScriptweb in a browser, node on Node
Pythonpython
Gogo
JVM (Java and Kotlin)jvm

Override it in the configuration when a name says more, for example platform: "api" for your backend and platform: "worker" for a queue consumer. The naming rule is the same as for environments: lowercase letters, digits, - and _, up to 32.

When an event arrives without a platform, the server derives one from the SDK name and the OS (lyrelog-swift on iOS is ios, lyrelog-js with os_name: "web" is web), else from the OS name itself.

The project's platforms

In Settings, the Platforms section lists what sends events to the project, one card each with what it is:

PlatformWhat you tell LyrelogWhat Lyrelog does with it
iOS app, Mac appIts App Store listing: search by name or paste its linkShows the app's name, developer, rating, version and bundle id
Android appIts Google Play package (com.example.app) or Play linkFinds the app's name and icon on Google Play
WebsiteIts address (example.com)Finds the site's icon
ServerIts language: Node, Python, Go, Java, Kotlin, Swift, Ruby, PHP, .NET, Rust, Elixir or OtherShows the matching environment rules

The icons found this way can become the project's icon (Icon in Settings). Removing a platform forgets what it was and its icon. The App Store listing goes when neither an iOS nor a Mac app is left.

When events from the last 30 days come from platforms the project doesn't list yet, Settings says so and offers Add them. Event platforms map to project platforms like this: ios, tvos and visionos are an iOS app, macos a Mac app, android an Android app, web a website, and api, node, python, go and jvm a server (with its language when it's known). A website or an Android app opens as a card to fill in, since it needs its address or package.

Only owners can change the platforms.

Filtering by platform

  • Top bar: when a project hears from more than one platform, the environment picker adds a Platform section listing each event platform seen in the last 30 days, plus All platforms. The choice is remembered per project in your browser and applies to every page. See Environments and platforms.
  • Explorer: the Platform filter takes one or several values, or excludes them ("Platform is not web").

Both filter by the platform on each event, not by the project's list.