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