Skip to main content

Embedded URL

You can use the embedded-url spec property to embed any publicly available webpage into an additional tab in the specific entity page.

By using the embedded_url spec in a Blueprint property, Port will display the url as a new tab matching the provided URL in the blueprint's entity.

note

Make sure the URL you want to embed in Port is publicly available (i.e. not inside a private VPC or only accessible using a VPN)

Prerequisitesโ€‹

In order to add an embedded view tab into your specific entity page, all you need is a publicly available URL with the data you want to embed.

Embedded URL property definition in Blueprint schemaโ€‹

Definitionโ€‹

{
"myEmbeddedUrl": {
"title": "My Embedded URL",
"type": "string",
"format": "url",
"spec": "embedded-url",
"description": "embedded-url Prop"
}
}

Examplesโ€‹

Datadog dashboardโ€‹

In this example we are embedding a Datadog dashboard in order to get application metrics directly inside Port.

Add the embedded-URL property to a Blueprint:

Blueprint property definition
{
"datadog": {
"title": "Datadog",
"type": "string",
"format": "url",
"spec": "embedded-url"
}
}

Create or edit an Entity of the Blueprint you added the Datadog property to, and specify the URL to the Datadog dashboard:

Datadog Entity edit example

Now go to the specific entity page of your Entity and the Datadog dashboard will be visible in a dedicated tab:

Datadog dashboard example

New Relic Chartโ€‹

In this example we are embedding a CPU usage New Relic Chart to get infrastructure metrics directly inside Port.

Add the embedded-URL property to a Blueprint:

Blueprint property definition
{
"cpuUsage": {
"type": "string",
"title": "CPU usage",
"spec": "embedded-url",
"format": "url"
}
}
Go to new relic and extract the chart URL of a specific chart

New Relic get embed URL

Create or edit an Entity of the Blueprint you added the cpuUsage property to, and specify the URL to the CPU Usage chart:

New Relic Entity edit example

Now go to the specific entity page of your Entity and the CPU Usage chart will be visible in a dedicated tab:

New Relic dashboard example